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SECTION i 
INTRODUCTION 



1.1 GENERAL 

The GA 18/30 Disk Based Operating System (DBG8) is a comprehensive, ussr- 

oriented operating system which provisos the Usar with the following features. 



m 



a. System Operation. 

Provides efficient operations under monitor control - 

Simplifies manual operations. 

Reduces operator errors and job set-up time. 

Provides simphiied control sequences. 

Allows efficient file control 

b. Job Processing 

Initiates assemblies, compilation, pro^r&ffs check out and axocutioft. 
Assigns files &nd peripheral «<£ujpn»ent. 
r' -^.AUoe$t»» MMncry. 

Provides batch-processing of jobs, 

c. Input/Output System 
I/O drtveet . 
I/O interrupt control . 
D#t$ packing ana unpacking. 
Device independent icg ical I/O unit* and devices „ 
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Standard Processor Master Flies, 

Symbolic assembler, 

FORTRAN 

Core tmage converter .'loading and linking program) 

Source Language alitor. 

Debug routine. 

Programmer /Operator Aids 

Program execution by program name. 

Diagnostic error messages , 

Simplified calling sequences. 

Memory dump. 

Directorted files. 

System Preparation and Maintenance. 

Simplified system generation. 

Replacement and deletion of directorted files 

Listed output, of fue directories. 

User program in directorted £Jlas. 



* «** 



O&OS allows job processing m proceed under the direction of control cc-mT^nd^ 
Control e&mot&nds may be submitted by the programmer or prepared ay the 
-ag&ps&sr 4hw! input to the svstera from the teletype Hovboard card feeder., or 
paper tape reader. Jobs may bo batched or singly processed under guidance by 
the operator . 
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DBOS operates in U"ie i©itois«nrtg minimum hardware fSMtfiguraftcn' 

a. A Gk 18/30 Industrie i Supervisory System Compear *-*tn Hi§2 -*-cr*; 
of cor a memory. 

b. 3 Modal 1362 or 1363 teletype unit 

c. I Mod«5 -34: or >?4~ Dish stcrac-a uni* 

fh*» ?'■*•--••••; or., o* »h# fcjjowino per£pher«is *?•>'■ w->:.*.*: *•*«« ritiMtv o' DBos. 

a, Mode.; l?n ~sr-; ; r*»* \*-'» r 

b. *-?--v , k^ ', S'3 ce-«j punch, 
c Mode' 12*,? !in* sfirtfef. 



V-.r s v v '- 



:-*- 'e'.jf 



».. Model 1322 paper >*pe pursrh 

DBOS gener»tror •-^-;\ire.3 >.5oh -?peea nape? :<r;>t or -mtc ir.Uiit, This ^ariua- 
ifc attendee* ss * csnerai refot'trtuco >ftaivj&j n> bt ut'ac i.-v Lsc-i,-? p-v-,«* a '^n:»>- .i. * 
operators. It pro.--.c^h ascription* o\ DBCS i^r.-cfessmg tunc--' ■..* iiu.~-., :., 
control command configurations - and standard omca&sof usaoe: *v*t*.£ 
openviop.s, incUidiiio. ooct strapping, system ansry 7n*'rho'is ,,*-!« jv**»v^- 



**et »a*a« « r * •' * i ■«♦-•' 
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SECTION 2 
DBOS PROCESSING 



2.1 GENERAL INFORMATION 

The GA 18/30 Disk Based Operating System (DBOS; provides complete processing 

capabilities in the following areas: 

a. Assembly and compilation of source language programs, 

b. Loading and execution of user programs. 

c. Maintenance of user and system programs on disk storage. 

d. Device independent input/output operations, 

e. Sequential job processing from control commands, 

DBOS consists of the following components: 

1 . The Monitor, 

The monitor is a core resident program which processes internal 
interrupts, loads system processors from disk, processes user- 
programmed returns to DBOS, and contains system-wide parameters.. 

2. The Logical I/O System. 

The logical I/O system Is a cote resident set of input/output 

drivers, I/O device tables, and a central control routta# for | 

performing operations according to logical device specifications. | 

_-__«__ -I 
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nmQoum 

| 

3. The Executive. f 

| 
The executive is 3 system processor which is loaded by the 

I 

monitor to process control commands, Th* eoniroi commands defin® I 

1 

i 

logical unit assignments, program assembly or compilation, program i 

\ 
execution, and disk utility ly notions.. 1 



DBOS is initially created by © system generation process. This process \t> \ 

i 
I 

described in section 4 of this manual. During system generation, the? systaws | 

I 
is written onto disk &r.d , when it is to be activated . Is rear, into sore vJs I 

a disk IPL operation (see section, 3,. DBOS Operation), | 
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2 > 2 CONTROL COMMAND INPUT 

The DBOS user communicates processing requests to. the system by means of 
control commands , Control commands are read by the system &nd input to an 

80~cliaracter storage bviim for processing , 



Tnese commands have the following syntactical format* 



# 



where: 

$ 

command 

[option] 



comments 



$command f , option 






LS comments 



is tha control command Identification character and is always 

the first character of the control command Input record . 

represents one of the legal command syntax structures. 

represents an optional command modifier. Mi data within 

braces is optional including delimiters . 

indicates a blank character. This blank acts as the command 

terminator. Only comments may follow, 

represents an optional string of characters from the GA 18/39 

character set assd are included for- annotation pus$N!»®$&» GoeaMMtta 

are listed on the system log but have no processing function, 



2 . 2—1 
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Control commands are input from the system's l©gi<3ai unit CG, Tim fc«i@typ« 
keyboard is the standard device assigned tc logical unit CC . The most 
meaningful alternate CC devics is the card reader since this providos batcsfe- 
processing capability to the system. 
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2.2.1 CONTROL COMMAND INPUT FROM THE TELETYPE KEYBOARD 

When logical unit CC has its standard device assignment (teletype keyboard) , 

DBOS indicates the start of a new control command sequence with the message 

DBOS CC 

This signifies that subsequent control commands are to be keyed-in by the 
operator. The system processes these commands as follows: 

1 . The system signals its readiness to receive a control command 
by output of a control command request which consists of a Line 
Feed, a Return, a ? and a space. Only following this request can 
the operator key-in a control command. 

2. The operator may key-in a control command of up to 80 characters, 
including comments. Keyed-in control commands are terminated 
by striking the RETURN key on the keyboard (no trailing blank is 
required). Processing begins immediately following the RETURN key. 

If comments are included, a blank (space) must appear befor® ths 
comment string. 
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3. Key-in errors may be deleted, if detected prior to the RETURN key, 
in either of two ways: 

a) By striking the RUB-OUT key on the keyboard , the operator 
deletes the entire command. Upon receipt of the RUB-OUT te®y, 
the system immediately requests a control command as in I . e 
above. 

b) To delete the last n characters of the control command, the 
operator strikes the left arrow (-*«- } key n times. Each time 

the •— Is struck the last remaining input character ig deleted from 
the input record. 
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2 • 2 • 2 CONTROL COMMANDS INPUT FROM CARDS 

When logical unit CC is reassigned to the card reader, the system reads and 
processes 30-column card image records. The $ character must he in column .! 
and all characters up to the first blank constitute the control command. 



# 



Once the card reader is assigned as the CC device, it continue?- as the centre! 
command input medium until CC is reassigned or the system is reinitialised* 
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2.3 CONTROL COMMANDJ^mf^ 

Control Commands are always listed, during processing, on the system io<? 
(logical unit SU. The line printer Is the standard SL device, If SL is assigned 
to the teletype printer, the listing is suppressed if the CC input is from the 
teletype keyboard. 



# 
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2.4 SYSTEM CONTROL COMMAND AND COMMENTARY 

The following subparagraphs define the specific control commands acceptable 
to DBOS. Each must conform to the general format specified in paragraph 2 2, 
Optional elements are indicated by brackets ([ J). An optional element 
includes all items within the braces, i.e. , f, Pi indicates that the coram® and 
? may be omitted. These commands define the major processing functions of 
the system. 

Commentary 

The comment command allows additional commentary in the control command input 

stream. It is of the form: 

$CA commentary 



Example 



$JOB 

$C. 

$A 



Assemble real time executive 
10/15/70 version 1 , modification 2 
Invoke assembler 



! 
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2 '■• 4 • l LOGICAL UNIT ASSIGNMENT 

Each DBOS system is generated with standard logical unit assignments to 
conform to the particular hardware configuration . This includes User disk sector 
allocation , Table 2-1 defines the generated standard assignments , Logical 
units may be referred to symbolically or by number {0-1 5), 



A logical unit assignment command is .provided which can override the generated 
standard assignments. This override can be defined to continue for the duration 
of only one JOB or through multiple JOBS. A JOB duration is defined as the 
period between the occurrence of a $JOB command and a subseqia nt $JOB 
command. Programs which use the Logi cal I/O system for input/output 
may, through use of this command, use any devices. This command assigns 
one of the logical units shown in table 2-1 to an© of the files shown is 
table 2-2. It has the following format; 



r 

$lun-file (name) 
(bs-es) 



1 

L< P J 



where: 
Sun 

lile 



represents one of the logical unit names or valid ti®£is?ml 

numbers shown in table 2-1. '"'^'M^ 

is the name of the device {OR, PR) or "file' CDS, WC) as 
shown in table 2-2, to which the logical unit is being assigned, 
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(name) 



(bs-es) 



represents a program name if "file" is a directoried file 
(DS, LB, DC or UL). If (name) is used, the logical unit 
assignment is to that program within the specified file, 
represents a disk storage area. M bs ,: defines tha beginning 
sector address (in hexadecimal) and "as" defines th& ending 
sector address (in hexadecimal). If this option is used, the 
logical unit assignment is to that area of disk 
specifies that a LUN assignment is to be maintained through 
successive JOBS. Logical units defined with the P opt^n *>;?< 
be overridden by an IP I operation. When the P option x% omitted 
the LUN assignment will be mair-ialned for one JOB sequence 
only. The next $JOB will reset th@ LUN assignments to tlm 
last user specified LUN a tagged with the "P" option. LUNs 
not specifically specified by the user will be reset to th«s 
generated system standard. 



Examples: 

1. • $LO TV 

The teletype printer is assigned as the listing output device, 

2. SCC=CR 

The card reader is assigned as the control command device. 
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SSI»WS 



The working sourc® language data file (WS) is assigned to symbolic 

input; i.e. , subsequent symbolic Input will be taksn from th@ WS file 

on disk, 

$SI=DS (USRI) 

The symbolic input logical unit is assigned as program USRI which 

is in the directories! source file CDS), 

Note: Caution must be exercised whan assigning non-standard 

devices to OM, CC and SL. For example; assignment of the 
line printer to CM to list FORTRAN error messages is inadvisable 
FORTRAN expects to receive input from device OM which is 
not possible from a line printer. Caution should always be 
exercised not to assign output only devices as input files 
and vice versa , 
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2 . 4 . 2 JOB COMMAND 

The JOS command sets the logic*!, unit assignments to the generated standards 
(table 2,1) or to the lest user specified assignments tagged with the H P" option 
Case 2,4.1} In addition the JOB command Initializes (opens) disk files, This 
command may be used at any time, but it normally is the first command in a job 

stack . 
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2.4.3 COPY COMM AND 

The COPY command provides file-to-fiie copying capability. It also provides 
a method for defining names of programs in directoried files (DS. LB, UL 
and DC files) . 



The format of the COPY command i»; 



f a 1 r 



$COPY 



L D J 



, file, 



(name) 



iff- 



(fos-es)j 



Source — J 



C 

D 



, file,, 



iname; 
(bs-o*} 



Destination 



Where; 



a 

c 

D 



are optional data type specifications 

A- specifies ASCII data in 80 character record form. 



B- 



specifios binary data in 54 word assembler object 
or cor© image record form . 



L_ 




*• *» J" 
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— » 

: 



, fllOj 



I (name) j 



J^(bs-os) 



J 



C- specifies unchecksummed binary data in 60 word 

record form 
D- specifies binary data in 320 word record form on disk, 

represents the input (source) file involved in the COPY 
represents the output (destination) file involved in tha COPY 
represent options, and (name) and (bs-es) have the same msar.ing 
as defined in subparagraph 2.4,1. 



When the COPY command is processed, data is copied from file, to Me? until 
an ASCII END, binary end fOFOO) record, end-cf-data ($EOD5, or end-of-flie 
is encountered. An ASCII END may exist as the first or second field of a 
source record. Ti jrefore a label may appear before the END record In an : 
assembler source file, , i.e.. NAME END. NOTE: The CND -statement may 
not Dogin in columns 1 or 21,. 

If A, B, G or [j is not specified,, the data type is determined from the file 

name. Disk files are assumed to be 320 word binary records. If the file is capable 

of maintaining both ASCII and binary data, ASCII is taken as the normal type. 



L 



The DBOS s/stoit. Tamtams implicit definitions for all files, whether disk 
resident or external devices. The optional typo specification overrides those 
implicit definitions, i,c, $COPY,CU,A In this example the Implied' 

definition ol type binary tor file LB is overriden and forced to bo ASCT;. „ Such 
action, while permissible, will create improper structure of the file for the 
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inserted vrogrsm (LB m»y contain c-nh' typ*s "*" deta^ The -isor *ho\-l.d only 
' specify a type code whan: 

1 . The destination file is of a "lypm" different from the input file "type" . 

2. An external £11® o! un check summed otoary data is to be copied., tyss>e *C S 

3. Both files are capaW# of cont©ialu@ $SOH end klsssry data ®M*fp@- 
"binmy* is required. Hote: the default type far such files is. 
ASCII, (i.e., CR, CP) 



* 



ud MJ wou^ hat 



2.4M-3 




mmssAi JwrmnATMN. ma. 



LIBRARY EXPANSION 



When a program is copied to a directories library file (LB or UL) , the program 

nameis} Is taken from the input program. Multiple programs may be input to 
create or append a library. The input must be terminated with an end of d&i& 
($EOD) record. (See section 2.4. 12 for use of $BOD.) 
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WC AND DC INPUT 

Core image data are absolute programa with subroutines propsrly iiftJcad and ail 
external references satisfied, fir», ^rd)^: Jte,^wp(W!WP*^*o. b#. Aa -oo«» . *«■»»• farssat, 
they must have been processed by the ©ere last®* converter (see Mtoparvflraph 
2. 5.3) which leads binary object pnaraMr liokff-pffoffMft ® lament* and -p«r- 
forms proper relocation adjustments, or the a«g#sabl®d binary object fross an 
absolute assembly. No external references may be used in assembly. Precede 
$A with $BO=WC to create object in WC file , 

Once a program is in core image format, it can be loaded from the DC or WC 
file and executed without further processing. 'See paragraphs 2.4.20 and 2.4.11} 

$COPY Examples: 

1. $OOPY, DS (PROGA), WS 

Copy PROGA from the DS file to the WS file. ASCII 80 character record 
form is used. 

2. $COPY\ B, CR-. LB 
$EOD 

Copy a binary file from the card read®- to the LB file. The binary" fil* 

is identified in the LB directory according to the nasss© con$sin«d ©& 

the input program data records. (B specification is redundant but 

permissible.) 

The last copy operation affecting a library must be followed by a SEOO, 
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3. $GOPY,^,DC*PftOC30 

^ Copy the Wrtcteg toritln&fl* file *WCJ into the direetorted ewe 

***-**? -»? fJMQtt program 

DC directory. 

4. $COPY;dS{PROG5),LP 
Copy program PROGS from the 08 flte to the line printer (LP) . 

5. $C0PY.DC(NAMB)3,W 
COPY program name from DC to the teletype. 



i'ticH - 



'■"■ ■ .& ■■■■'• 



I 

i 

r 
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2.4.4 REPLACE COMMAND 

The REPLACE command provides the capability to replace a previously Rawed 

program in a dlrectorled file with data from another file. 



The format of the REPUCS command is: 



i ■ ii . j 'i . i u. IIII 4 I .H . N ,i i i m 



».', ' .■,■>' A ' j,-">- 



•.^ : 4i" 



\>X' 



*/ f A 

JREPLACC.file. (name^ LB 

J Cba-es) J c 

D 



destination 




source 



where: 

,file 

(name) 



1 



, A 
, B 
, C 
* P 






represents the output file, i.e. . the file which will receive 
the replacement program. 

represents the name of the program In file, which is being 
replaced. The name will be assigned to the new program unless 
file, is a library file. In this case the program name will be 
taken from the input data ... 

are optional data type specifications, as defined in subparagraph 
2,4.3, 

fltejNMCNfttc the input file; i.e. . the file from which the replace- 
ment program is to be copied. 
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(name) 
(bs~«s) 



are optional and have the same meanings as de$£aedin 
subparagraph 2.4.1. 



$REPLACE examples: 

1. ' $REPLACE,DC(PROG7),WC ? 

Replace PROG 7 in the DC file with the program in the WC file. 

2. $REP1ACE,LB(SUBA),CR 

$EOD ; 

$?ACK 

Program SUBA of the LB file is replaced by the binary record In the 

CR file. The last REPLACE operaUon affecting a library file must be 

followed by a $€OD and 5PACK. 

3. $REPlACE.DS(PROG23),A,WS 

Program PROG23 of the DS file is replaced by the symbolic program 

in the WS file. 

NOTE 
The REPLACE command does not write th# new program 
over the program being replaced. Rather, the new program 
is written in the first unused space of the file and the "bs" 
and "es" addresses in the directory are altered to reflect 
the replacement. A subsequent $LOiR command would 
indicate the area occupied by the replaced program as * 

****** unless a $PACK command has compressed the 
file. See $LDIR (2.4.6) and $PACK (2,4.7). After re- 
placing a library routine a $PACK must b© executed . (See -2.4. f+) 

mtmmmmmmimmf^Bmmm^mm^^mmWfmmrf'l^^- w»muw h iii m i » i i i w i m *m)im mm*m mmm am n i nim tei^mwm m mmtimmm miSlmW SSSSBmmm 
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■Ha 
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2.4.5 DELETE COMMAND 

«— «— W— 111 ) ■ <■ ."" ■' II— '"" I " ■ — ■■■■> I'll *!■)■ 

The DELETE command is used to 
dlrectcried file . 



The format of the DELETE command is: 



-■9S&i 



SDELETE, file (name) 



where: 



, file represents the name ©1 one of the directoried files (OS, LB, 
tTLo* DO 
(name) represents the name of the program which is to be deleted. 



Example: 



$ DELETE, LB (SUB A) 
$PACK 



The program named SUBA is deleted from the LB file. Note: A $PACK command 
must be executed after deleting subroutines from the library. See ^W;WS 






2.4.S-1/-2 




m» , i, kf,iV ,*fi <*»jni , *:m m kf*m * *»" >' i™ i 



m «ii 'mn» i n i »,m»j i 



i » w — 9 a mmm m 



The list directory commend causes the current status oi a directcrled file to 
be listed on the gL. (system log) unit, 

..... .*• .. . 

The command format is: >* 

mmmmm mm m m m » < mmwmmmmm nm ■■■ 1 mm ■■ m i i»M»««w».wwwwM4wwjwTwwe« ■ " * «M*fxiM M * i mmB.r* m ' inmm m iwnwm*i *m£ttimMmmmimmmMmmm* ii ' » tm mm»m$ 



SLDIR, file lbs-eel 






where "file" is the name of the dfeectcrled file ts&ose direct**? i$. t© be listed. 



The LOIR listing has the format: 

bs es type rpr tpr name 

for each item in the directory, "bj" specifies the beginning sect©? address 
(in hexadecinn 1) , and "es" the ending sector address (in hexadecimal) , of the 
disk area assigned to the storage of program -name". For library subroutine* 
typo indicates the program type as 



LIB Celled by UBf 



BNT Ceiled by C*I£ 



1.4.6^1 
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"rpr" indicates the precision of reei mimb«B «^ 'tgr* indlcata* the 

of integer number s as . , ,„ •,, 

■ •," .a, ■•. .■ .. : - ■-•*..'• : ..i 

blank Unspecified 

SPR Standard precision 

EPR Extended precision 

If an area has been deleted or replaced, the listing format is: 



: '*<& 



\ 



-vMxm.-- 



bs es ****** 



5S-flte '"'few- "; ' 



2.4.6-2 




«mksm£ AtmmATxm, tm»~m 
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a.4.r«i^i^ceto»aa>igfei 



The pack diiectoried &le cawnaad peek* 4t» ej08*«sts Mi directories! files to 
eliminate unused sector* resulting from fra&am deletions or replacement** 



The format el the oommaad im 



,^- -. - 



$PACK, file 



where "file" is the name of one of the directoried flies CDS, LB, UL or DC) . 

NOTE 
For proper processing of libraries (LB or UU by the 
Core Image Converter . The PACK command must ba 
issued following any update to the liferery . 



• 






» ■< 1 1 m m mi itmmfifimmm 



in i ^ i nmw im h ^m 



•'^:^-:' 



3.4.7-1/-2 




i i ii fr«n/ ii pniiiu>Mt i 






sb** 



2.4.f POMP COKIJIISgD 

tHe dun* ooMaaad produces » &»ggijg^&Ua^ e^« file «»&« 

log) unit. 




1% -v"'^l%''* 

* ? ~n nr isnesi T *. 



The command format is: 








A 
B 




(name) 


$DUMP 




r w* 


i^;': -■..,■ , 




>- D 


■ 


(bt-es)^ 



."r.> 






where: 

,A are optional data type Bpoclficatkme 
,B as defined in subparagraph 2.4..3« 
,C and define the data type of the file 
,D data. 
.. file is the name of the file to be dumped 

[(»»«»> fare optional cad have the same meanings as defined ia 
(bs^eeikuoparagraph 2.4.1. 

A $DUMP listed tine has the format: 



loc dataj d«t« 2 ... data R 



-y&Z ^' * 






''"*'?'■■, 



.* J**£ 'W^R'fi^*^ ■ 



2.4.6-2 
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liMXl mmaM junmumm. ms^ 



m&im-iim 



JUL 



mr -Tlhffri ^jffjg«^ 
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loc 



represents the relative record location {Hexadecimal) of the 
first data item In the first data item to the line. 



data 1 represents a data item 



n is 16 if SL is assigned; to the line printer ortd S-'ifrthosfc 1 !*' 

' assigned to the teletype printer. 



tfiott* as* 



K 



v^,.*- 



If the nth item of a line (8th or 16th Item) and the next n items are ideatioal, 
the React line is not printed . When this ooeurs oh* response occurs . 



Assume a block of 32 words contains a recurring series ot numbers; 1/2, & 4* 
5, 6, 7, 8 followed by a disimilar pattern's," 7, 6, S f 4, 3, 2, 1. 



The listed output would appear as two lines as follows: 



<■?■«■••" 



*e i»in»iin»« 



$»4„M 



MM* 



LOC Datax Data 2 Data g 

1 1 2 3 4 5 6 7 8 



33 



8 



|DUMP,DC{PHOGA) 



6 5 4 3 2 



1 



„ *£<-<? r . 



>irliM««iiSr *if»H 









■-■*«»•»#***«**■ 



effijBfi 



;^:*.;, : ;*■' 



.■;■'' v 




i » m i n i ill i i lillt i . n ' H i * 1 . 1 *1 rn " ii " ii ' i ■■! J.-» ' i ■" 



Dumps the program named PROGA. pm the DC fits. 



§DUMP,B,DKU5F0-15P5) 



Dump* the binary data from toe DK> file, sector* 1$F0 through 1SF5. 



4.S-3/-4 



msimifmM9$X!!LdB& 



&?$ 
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V>. y.kili 



M?H 









to execution of the system easeeutiwe . |j^ PDU^ Gwaawseri is$g^»*~» selective 1 
dump erf this core memory to fr«x<&*3*dsiaJL 



The commend is: 



$P 



V',,..- .-" .:■ .». .,>-. — '-' f '; 








.$$f ■.; ~i*. " ^ > j'V'; 1 * 'vife* .• '•-*;•!>■ . 



where: 






;oC,.tfe®iBhii,^ii» 



'v-^'tw;'-^ ■'■'??■> 



f IpCj represents tfe# looglMt 

, ■ "*..•"■. „...,... 

memory word to be ^mpeci. .^w^&S^* 

-locg represents the location (Ih hesasdeeteal) of the lest. core 

memory vmd teba &&&*&* > ..% . .„ r '.' „ ,. *ff ; ~ : P 



Output. raimttlne from PDUMP is o© the gt (ssrsf®m 1©$) ^ ; .d3%0^»%g|gg 
lines lathe following format: 




loc oeta. 



•■*v* *te$*. 



■irf;*^^'- 1 ' ' ,;: 



n 






^■■r&y&S £?■'■■■ Y,,.j 



-■■ i^5?*j 



;*- 



• 4* §"•! 






1 '' " V\- • ;y :\'r>* 







where:'' 

l«o ' " the memory locatien 






..-r-t-jH 






line, "toe* is always t modulo 8 address . 

represent the 

tvU If & is assigned** *to§ Una printer and 811 SL is as 

the teletype printed' vir-VKct 



p. 
r 




^a&^av^T 



If the nth item of a line (8th or l$th item} a$d the as** n items es» id«§glfcalv ; 



the neatf-Hae-liS -not f^ptpew* 
section 2.4.8 for listing example. 




'■'*•?' ,-•■ ■■':-— "v'^* , -* V;; v--::, ■■■' •'■*'--■ ■■'■"■" -SrS:.'-. 



ir- 



If the optional ["*, loc| - iocjjTis not present in <&e ?DTJMP commend , the 
entire core memory is dumped. 






■■• ■■':,; i 



The system seves the program agisters in tile following locations: 



R EGISTER 

1 
A 

Q 

Index 1 
index 2 
index 3 



1£CAT10N (HEX? 



/77 
/78 

/79 
/7A 
,"7B 
/7C 







u. 



•• T ;iVKft'*r»'-' -,:W* ; '"' .■•'■' 



nTi frrr i fflffR. 
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examples: 

1. $PDUMP,15A5-15B3 

Dumps the contents of saved core locations /15A0 through /ISBf . 

2. $PDUMP,70-7F 

Dump the contents of saved core locations /70 through /7F which 
includes the program registers. 

NOTE 
The monitor performs a core save function everytima it is 
entered by a functional program. Control may be returned 
to the monitor in any of several ways: 

1. Manual entry at locations /71 or/73. 

2. 'Programmed return via a 

a. CALL MON normal return 

b. CALL MON£ error (abort) return 

c. FORTRAN CALL EXIT or STOP. 

d. Console Interrupt. 

Refer to sections 3.1.2 through 3.1.6. 
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OtMtHAl AUTOMATION. IMC. 



88A00142A 



2.4.10 PROGRAM EXECUTION COMMAND 

A program which is contained in core image format in the working core image 

file (WC) may be loaded and executed by use of the following command: 



£ name 2 1 



$LOAD , name 



where "nanr^" is optional and represents the name of a second program from 
the DC file which is loaded along with the program from the WC file. If M name 2 ' 
is present in the command , program "name " is executed when ioading is 
complete. If "name 2 " is not present, the program from the WC file is executed. 

Only one program may be contained in the WC file at a time. 

This command is similar to the Processor execution command (2.4.11) except 
that it allows loading unnamed programs . 

A program may be placed in the WC file by a $COPY operation. 



I 

2.4.10-1 
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Example: ^rkP'^ 1 ■<''-■■■' ■■''■'. 

$COJY, WB ,WC would copy the object output from the 
assembler in file W» to the core image file WC. $GOFY. 
CR, WC would copy an object deck %o WC for execution. 

The following command eeqsuence will reauU in an executable program in file 
WC from source media. 
$106 

$A and $F 

Source Statements 

$E0D 

$CIC 

[*MAp] 

*BUILD 

$LOAD Immediate execution or 

$JOB 

$BO»WC assembler object output to WC 

$A 

$LOAD immediate execution 



A second program may be called Into core torn the DC file along with 
gram from WC . 



2. 4. 10-2 
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The format: 



SLO*D,PRO<52 

where PROG2 is a program stored in the dsrsctcriod fcie DC. 

The second program must be origlned such that it does not overlay tshe ^ program 
loaded from WC . (See BOUND directive under CJD, section 2.5*3J:jft£<am«iii£.< 
bier ABS and ORG directive may be used to origin an assembly' language program.) 

A typical use tor the double program caii is in debugging. The command 



$LOAD,D 



will load the program from WC and the DBOS debug routine from DC. Exe- 
cution will begin with debug (see section 2.5,5). 

Note: The debug program occupies /700 locations of high core, 
(origin /7900) 



Revised Dec 70 , 2.4.10-V-4 



r 




©mm At AtfRMMflMt DMC. 



6&90U2A 



2.4,11 PROCESSOR EXECUTION 

Any program may be specified as © -proo*Mer feylM^feg tfeafc pas&fr®® 4iQffMl:|B 

the directories cor© im®i?e.lli® (DO wife its .smm -to the IXTdttwctfog^^.v, ,,-,;; 
number of predefined processes are- ftMM*&4ft?SK38. tfcra am •s:;s%^f5. &' 
paragraph 2.5. 

A user way add his pm®ra*?iss CiKe©$s*«Ki to tfcfrSC m® W*—'<e4 m® : -mm'- 
command , 

Examples: 



SCOPY , CR , DC( NAM EX) 



$GOPY,WC,DC(FROGl) 



Copy ®n external program into IDC 
from cards. 

Copy toe unnamed program in WC teto 
the DC file &nd call, it PROG1. 



Programs which are in the DC film may fee loaded «ad fsxeootsd by wNi^^p^ 
following control command: . - || 



•«-« fe^tawsWWiB 



$nam@ 



I | , n«me 2 j 



>—**»««!» 



2.4.11~T 




mmmi AyrmsATMm, m&. 



sbaoomm I 



wnere: 



nam® represents tk& &®,mm of tb® ^©grass ■(processor) to he ieatfed , 

i 

r,narn92] is optional and mpr$s«fits thft rmmm of a second program from* 
the DC file which is also to bs loaded . 



If M name 2 " is specified both programs are loaded into core memory and program 
"name2" is executed. 



Normally, "name " is a debug program, 



Example: 



2. 



IPRG15 

Load and execute program PRGl'5. 
$PRGIS,D 

LsMfcd both program PRG1S and D (the debug program) and execute 
th« 4«by$ program. $e® section 2,4.10 for examples and origin 
/'tMtciotionii « 



2.4, 11=>2 




I""*"* flf j w— ww wyi wiwr wiw ■K^ fri . r .w w^ i iMy ij i l ^ 



2.4,12 WRITE END-OF-DATA IMAGS jljPgl 

The Core Imago Converter, ,CI£*.:te*^:Sjifll^^ 

to four separate binary files. ,ascfe,ft.i»;aa«^i««r^»i^^ ; ^t«,'-a -Jt&DD ias*@s 

record. This image causes the C^:^'tmitltaf^>'MtNM«»'<^«nft &-» assdi#Ssm©e® 

■ " ■ /* 

to the next or if the file is IJBrt«,«te4^^B«e»a«te«,csH^l<i^8ir'» 
The command $£QD will close s ftl*. " V^-.' "is^r^'-% 

Example: ■ ■•:. ; 4;* : *iM?jg : v<>- 



5J0B *' Vi -- 

$F Fortran mainline to Site SB*. 

$A Aa*embi«r eatp«ttolii<t WB, 

$EOD Close Mil file. Ho now data -awy be MitfwtStto 
NOTE: The $8DD oofmaajtd writes on lofi£»I«sti£ 
The standard assignment for BO is WB. 



When a library is being terminated the $EOD command writes into the library 
file instead of BO. 



I 



H 











...'.' ■ :\- ■ . • ■ ' 
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' -.*=■ "■ '■■' 


.-■ Vvii--> 


r.2- ■ "" 


"•-'■' 
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lJ 



2.4,12-1 



r 




mmmm Ammmmmsm** 



""""""WKI* - 



Example: 



: ,'V- '. '"" 




$JQ§ open £li«s 

ICOP^', CR,UUb»~«d tmiM mam ttartftft* «» t». 

SEOD terminate UL 

$jOB reset limits for tf It to fttantitftf 

f® rai»k© use of this new Utawy tt*;Mkw^ stasir »Hfct to «ffl£ 



•^•^.iV 



*;# 



,.:■•<?,• 



$JOS 
$F 



ops« fll®« , ■;■■:>;; 
compile mais"iiia» 



Source Statements 

SEOD close WB file 

$SB=DP(bs-es) set disk limits for n®w S§ . 

SCIC call oor«<1iii^octt»Gffcae'' -*■■* 

*BUIID , SS buUd fevm** •«* iattti^-^SL^M to Si" in p^wmm 



■ 



$JOB open files 

$F ' compil® mainline 

Source Statements '•";, 

SEOD close WB file 

$UL«DP(bs-®s) set disk limits for new U.L 

$CIC call convm i% . M 

•SQIEg>,tri balM progriwt »sin$ -«a4y ti©s#f*#«ttes«B called te>y sftlilte® 
'■.. •:' from UL. 



. I 



Mi^^^i^M^A^M 






a. 4.11-z 




HtMMMW^feMMMK 



■|t,l|..lllniilM. l ljl 



$JOB open files 

$F compile mainline 

Source Statements 

$A assemble subprogram 

$EOD close W8&I© v _ , -...•?■•-*,!*-• "' 

fSB^DPtfes-e*); cet disk j&fcitt- fcii* .' "■*&: 

$CIG osMoanwurt *""; ',.:;_ 

♦BUILD, SB, UL build program using ail date 2rom new SB m& required 
routines from UL. 

NOTE: In ell cases the standard library file, 13 is used to complete build 
process . 



y&tf*"' 
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2,4. 13 PAPER TAPE SEGME NT ROUYIKE ClfRSSlI 

A large subroutine Library may ra<pir« « vhlvam Qtbiawy tap# to»-.$rwfc "&>!»•■ ■ 
handled in on® reel. Th© DBOS osaasaaad, $PISIfei» ! ,» ; islll J*u*wsfe a $?JS8& &as©« ' 
tc terminate a tape segment. The user may use feiE oomraand tet«f^s4ssBt® aft? 
number of segments. See section 2.5.3 for use of $REEL. 



IMuMMlHMlMlKK 



1 



i 
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2.5 PREDEFINED DBOS PROCESSORS 

During system generation (section 4) f a group of predefined DBOS pttfecweaors 
are copied into the directoried core image program data file (DO. Tfesse, aad 
other non-predefined processors , may be loaded end axacuied fef uaa o£ Sfcfc 
processor execution control command (subparagraph 2.4. ID. 

The standard predefined processors are: 

e. Symbolic assembler, 

b. FORTRAN compiler. 

c. Core image converter. • ' . 

d. Source image editor. 

e. Debug program. 

Each of these processors is described in the fci^wiag subparagraphs. 



il-r'a ■?!***'.„ •.. 



'-'-•'-• ■-■<v.' :••««?"■ ~?fiV>j 



.>«3i|M: 






«• 
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2. S. 1 SYMBOLIC ASSEMBLER 

The GA 18/30 symbolic assembler Is a two-pass assembler and is given the name 
ft in the DC file. Thus, it can be loaded into core and executed by use of the 
control command: 



The assembler uses the following logical units: 

SI Source input (pass 1 input) 

LO Listing output 

BO Binary output 

IS Intermediate storage (pass I output, 

pass 2 input) 

If the SI unit is a disk file, then the IS unit should be assigned to NO to avoid 
disk duplication during pass 1. 

If the IS unit is assigned to NO, both passes are taken from the SI unit. Thus 
if the SI unit Is the card reader and IS is assigned to NO the symbolic eeurqa 
deck must be input twice. 



* a v? o * "* i 







&ww?^mn&?k. mx< 



■t> iwaii'.ir,»-ffi::-T«»w..ft»»r»>^^\'.i«*K*T;p«wr-i 



;«tfew^sasr^V>«.:;^i' J #i^^^ 
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II 
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2.5.1.1 DBOS A ssembler Eattaaatera 

Refer to the 18/30 Programming Operations M&au&i tor assemble? us 
The DBOS assembler has bees extended b®y>m4 tfeas basic GA #s§«l 
extensions ere enumerated la the following pera<$ra£»is.. 

ASCI I Te^i tASCjJFa^jdo^ojp 

The ASC pseudo-op is ui<*r;nc»l to the ES-C staiecwsm described in fits <SA !S/lv 

Pro^ramminc/Operations Manual estcep*- Sfe&t ASCII data -strings «^». SKMNiPatwl, 



RBF/DEF Pseudo-op 



These features pa? r >\ 



, J UI IX 



programs, The -term e^iernai is -"nasal to indicate s program or storage kss&UOi'J 
no- -sssemblca witn :r*3 obia^i wofas, ASet'3 csfe.i© separately a F-*ai!i&l€s<5 Lnjt 
refe»ar»ced. ay the '.tM&ct progr>sn *'fe!d be en exa^p-:€ , 



jr tm t<- Reference symbols DEPrned in 3'mar s?t«us! I 



£>£f | 

A DBF pi»e •».-$•<-- n : r. is u?:,&8'f to sptrify that t&« symbol fe its vsrii&us ?S^I*I *&«y fee i 

REFereneed by an ^xt^rnat oioqrh rn, A DEF statement may not appear In an [ 

t 

i 

absolutes prooram. Ail i)EF's must appear at the beginning of the source ?U* tc | 

[ 

| 
which they make reference. M;£'' is identical t o an SNT except that tha defined \ 

t 

symbol n®ed_not_bj_ a program entry ;x>tet- Ft li 'jpansiftesafoie to d@ffc& « sya&Saal § 
used in the vanaoie rtetd o» r. OE.F v/ith an EQO statement, I.e., f 



>&m.' TOMH-iaWW »WHki»*V WiWfc* -..f ? v »,VrfY-ffg)?Mn»^>y«aFWi«»^«t^ JtM* ; > »»W»-)fi.W» Ma i « tgEW»|gg*.*JA«Wg! WWtt3»»«»aW.«»**HSW^'W^V*»WW«WMftfi^^ 



I 
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OWNIi SOU /*? -**«l^«ilMoli*t« v.«^»l^fi5!P.-to-.«y«**e>i-- 

A maximum 30 ENT and/^;p^f$mfee|gp*^ &* te^Mfc&te a fiftgftijpcspftm, 

A REF pseudo-op specifies that t&e s*flifr&in SW<v»s4ai^,i$^ 

REF's may occur anywhere tn a program. Symbols «M«h are d«el«n^ '..«» external 

by REF's may occur in a multiple item expression except as an operaasd of a 

multiply (*) operator. Machine instru ction whtafe oofltatn REPed gfwjjjgj? 

in their variable fields mu« Jbe_olJ^jEw^fW3rd or b^. format. 

Conditional Assembly •'•.^r- >.«;--. 

A QQ pseudo-op has been provided :■,$» 4MMrttf*:iwotni*uMV to h^i&de/ejeeMfe 
selected source statements. 

The statement: 

DO L M,N 

directs die assembler to staembJe^Qse -antt M.iiaes &J times, T&e values mzst 2a 

i ' ,: "VvV'-"." 

.;.:. , - t .-4i.<f:<>: . . ? 

within Uie range of and 255. All symbols used must be previously dm^*W& 

■/ *?'-':■.* C" " •''''*. • ■ '■;■'■"■ ■■-'■'- '',.-v„} . ■■<■. '■!*'/' ,*■■-'. .'.'■'. v V.;! . ...... . - - .... "'■>' ■ 

"1ft;'lt»#jftMtMir of lines, ia'flffeeW' tiito : ^ 

i 
omitted, it is assumed to be one. None of the statements within the ramgeot the 

■ 

DO can be another DO . 
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Examples: 

DO 

DC 
DO 
DC 
DC 

DG 



"j^-'^Jt 



r^* A* 



. Atdeg&ie *fc* o«xt 3 llsea 






.'ifr^**^^* 



I 

3 



.... "y-7»% 



*♦• 



1 






3 



Mart S lines " : - 



■•■..!■'-. .. i ->* "c*££ • 



■■■■ ■*'*■'-- 



Source Data Preparation rcwttt 
the DSOS Assembler will «©cept *ome& statements which originate to coiuflai 
1 or li. The r«m«tr¥***r ©f ttee efs&gsem Mtft be poached la relative ooiumui* 
i.e., tfae OP code* •»< U ts either started in columa 7 or 27. A maximum ©I $4 
«©lt«sf*8 ©I data is rea»j and ^aterpreleri . 



: 






•oewSw 
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2.5.2 FORTRAN COMPILER 



The GA 18/30 FORTRAN compiler is given Ums name F in the DC file. Thus It cam 
be iosdled into sore «nd m&mt®& fey. us® 61 tl*® ©ssitarol contmuui: - 



SF 



FORTRAN uses the following logical units: 



SI 


Source input 


LO 


Listing output 


BO 


Binary output 



FORTRAN is a one-pass compiler and requires no intermediate storage. The 
FORTRAN logical unit number u in ths FORTRAN I/O statements <».«,, READ 
(u.f) list) will reference DBOS 'epical unit u, The usar may use the standard 
assignment described In teble 2.1 or define his own assignments with the 
executive command. 

$u=fila. 

The *IOCS control card has no purpose and may, be omitted. The user is advised 

te use tfce standard DBOS LUN assignments. (See table 2-1) This procedure 
permits mv systenn LUN reassignment* to- b&. effective for ail programs 



ft i *? ■» &•"*"* 




mm/!**, am&mwmg. 



eMb&*mt& * m*m&iim*>**a* 



aiimn iatwai t/e&jiQmm&n***r**tim 
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operating under the system 



Example: 



tf $iun=CR 

then READ(iun,f} list would caus® data t© be tfiput fetsm the card masker* 
Note: The FORTRAN disk HEAD and WRITE operation* will always ws logical 
unit 13 which must tat assigned to tile DK (standard assignments Tfe& 
DK file is the only unpacked disk file, the d!*s: limit* fer ti» D& flite 
may be preset to any area ot the disk- Se& section 2.8.1 



Refer to the IBM rORTRAN IV manual for compter osaqe data (C26-371S-4). 
Note: The * control cards which are used to specify compiler options are 
not listed . 

Note: The *ONE WORD INTEGERS is the default option when not specified, I 
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Introduction ^l-i', u^..- 

General Automation supplies «iflMw*to»-llhnfy-«i«B«lo»»..lQr:«»A,otlli; v 
executives and operating systems, fheee routii»a generally ;..«*» suspiied t& 
permit access to Monitor functions by fee F0RIBAH programmer. This section 
will be updated a* new routines are made, available. 

Array Characteristics 

FORTJUUS ©» the 18/30 store* ersey* to rewaree order. That is, ARRaJfU) refers 
to the highest core address assigned to the array. This arrangement is contrary 
to the manner in which the machine and Monitor store data. Ift the tollowtae 

extension discussion paragraphs special characters wUi be used. These char- 
acters are defined as: 

N * length of array (number of variables) 
IQ » N*l value to be used as subscript base 

FORTRAN Logical I/O interface 

This subroutine provides access to the logical I/O system of DBOS, The tsfe-r,,. 
routine operates in two modes controlled by fee first argument. Details of UO 
are described in Section 5.0. 
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Model Data Trans far and Control 
CALL FLIO(IJ(IQ-l)) 

whero; " • "" : •"""'" "-'■' 

FLSO* nmm of roatin® ■ :■■ n^^m . 

I ■» control variable- for LX»ft .• 6 .?:■■-. -.; 

I = a dimensioned arr«v, Tha first variabls In array J smst <£*£!&• ■■■ 

* * 

the length of amy J . 
i.e., J(IQ-l) - length in words 

J(IQ~2 throuQh !Q-N) * Data 

This call results In a call to LIO of ths typ#; -■ -* ■' l< = 

CALL LIO : '-' *•■■■ • ' " ■■'■ 3;v***V-^i?.'" 

DC (I) '-*"«; 

DC I ' 

DC 

Mode 2 Device Status Test end Return 
CALL FLJO(IJ) 

whaftK ; --' ; - "'"'"■■■■■■ ■"'"■'■■'■■ --'•-":,>:;.:■. 

FLIC 38 name of routine ;^ v: ; 

I « control variable for LtO and must b# <0 \*v\~ 

• >,"'- 
•Vi-fe 

J -a variable which will contain the device status word upon * 

return from FLIO. 
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this cell results In a call to UQ of th« **$%& 
CALL UO 

DC (1) 



STO J -•'■■! 



The use of FLIQ require* that a control vartabte T b® Miabii&ad. ThU 

variable can b© defined in « DATA ttatMMOt. 

Example: READ 54 binary charters into army 1 from logical wait 12. 

DIMENSION 1(55) 
DATA IRASC/23MC/ 

J{SS> « 54 

CALL FLIOURASC.flSS)) 

Example: To test statua of logical-unit 12 
DATA ITEST/ZFOOC/ 
CALL FLKXITEST,*} 

The status of logical unit 12 will be stored in variable K. 

Note: A TEST operation must be performed before the next read/write call 

LIO returns immediately to the user and does not wait for operation 

complete . 
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FORTRAN DB QS BUIKN Interface 
This subroutine provides access to the bulk handling routine (BUIKN) in DBOS, | 
CALL8ULK(IJ,K) f 

wher®: 

BULK* name of routine 

I ~ BUIKN function (use DATA statement) 
J * a dimensioned array such that 
T(IQ-l) * word count 
J (IQ- 2) * sector address 
J(I0-3 through IQ-N) is data 
K * variable which will contain error status on return. 

BULK waits for operation complete status before returning to the user. 

Refer to Section 6.4.2 for a detailed description of BULKN. 

Extreme caution must be exercised when us ing this subroutine. It is possible 
to write anywhere on the disk including areas occupied by the Monitor and files. 
For safety, use FLIO or DEFINE FILE which monitors file boundaries. 
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..of-^f *.■■'*>">".' 



fhi GKU/38 Core Ij»a«e i|||^p|^i» : ^^«»l | i3ii^' ; €^ i» the DC Me, Thus 
J*.6pa be loaded lata core ^*?*5«s!^^ eommaad: 



$CIC 



The Core image Converter uses the ifeliowiag logical units to perform a core 
image ftie buHd: • >■• ■ ;/: v . ; i,- ; .^. •• ■■,; #!*<• : < .■ ■•.-■. ••---> ■ ■ y;"r;-;u, -^ 

BI Primary Binary Input ,. 

SB Secondary binary Input (optional) 

UL User Library (optional) 

LB System library 

CI Binary output 

IS Intei mediate storage (used to temporarily store object 

modules from BI and S8) 

SL Load map output (optional), missing subroutines list, aod 

error messages 

CM Operator messages 
CC Control command input 
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The Core Image Converter (CK8 perform* the fuaiasttans of fix** relocatable 
object code, linking together wain programs and subroutines and proa&ctn* 
an absolute cor© linage file ediich can then fee loaded «f©» the <Kfk sad 
by the DBOS disk loader. All CfC cere Image file builds are performed by making 
two passes over the object data. The first pass is required to build a &st ©f 
referenced subroutines, res©*** the *ubro««s*» entry addressee end obtain a ."..;:: 
map of tfemory. During the second pass, t&e executable care image output 
Hie is produced on logical unit CI {normally she WC file) . Note tfcet *&« OSC 
does not load the executable program directly into memory, hence all of avail- 
able memory may be allocated and used during problem program execution, 

The Core Image Converter can accept object program modules from up to four 
logical files. The C1C will first reference SI, which must contain the MAIN 
program as it's first object module and any number of subroutine modules. 
Optionally, subroutines may be input frorafsfjl Both BI and SB must be terminated 
by $EOD image records (use $EOD command). AH subroutines included in Bl 
and SB are incorporated into CI whetiier actually referenced or net. The user may 
therefore include object modules trtiich wiil b© vised in place of standard library 
routines to better satisfy his requirements even though they are not explicitly 
called out from his program logic. 



'•-■! 
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f&a final two iaput files are automates* libraries i-ULi ^optloaf^ and-,I&« Ofiiy 

moss g^ffoutsa^e ae$«*#*F €|£M8$ft; fc* ^.i^t^^o&f^mm ^m ^Sxs$^:J^0 < 
Hi® ■ €SB^«irtai-.««ter' : t^si^le. f^Mt ®*e* : *.Iisfsgy -)» #^|^,fifS£r#a£^»«: fiats 

- ^^jMMlacSlrae «*« use of l®v«^ iilffi»^^-M,g*#«^»si«. „., [^-^- 

qiC Control Commands: 

(Hams enclosed in brackets «*© uj&iona). , } 







»B0|JND £ low f ^i^h^^omii^t^lHmEL eoss^oaji , . ..-.. 

MAP - The optional MAP command jarovidies a m««issy mm 'Pi the r@#yJsto8 ^em 

image file, 
; :!Si^l*H5' - Tha optional SQTXStB 'ceraisa*id''ii , ©v4d^ ■•' m*ans to ,pnft^Si t&6 default 

B&emory boundary values. These defaults are designed to maximize user core In 

batch Job operation. Tne default value for each optional field is defined below. 
^^■■m Sil of these 'y«^te.s'.|8t^ be :«|W«rtj|bMl,- however all values hetweee 13SK|v;-. 

IN5$?if0 and the partteutsr ■weiue .#&«$ b© opacified. 



tA^. .'?;-- i 



low *- ftrsi location to be occupied by program , 
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;> - - ( 



?:- ; 



&$, first io-etca! f m m& L8 







9SftseiAt MtnmAtmss. me.. 



■ -** 
mm***.**** 



i ea aB Ss i^ mV i mf — m 



i- 1 i 'iinfutai a m i in m inf> iii iir '' KM lir f filiiili' I ■ 



:«K09i42A 



higte - l*st avaiUebie iocaUofi for 
commas-''''*- highest -addm** * 



is. «te3ar«d dmroamrd 



Definitions 

■ 1 1 1 I g l 'n. W »" ll . :i | ll' H i l W'fWn rty h 'rife i. 




storage. X^ifpr^tofed- 







f3ll&ariag. rules apply lor determining default values. 

hem - the first location following the D80S resident monitor, 

high - the last location available to DBGS (usually -end oi core). 

qomujoa - set to same value as hi#i* (!#©tei COMMON data ts stoie^^itefcwsMrds 

ia-cocaO - : :-'- : '^ 

MSKEL common - the orlgta^ INSKSL coa&ason is defteed by $*e expression 

(COMMON - size of coaHnoa). (Hote: IH8&EL common data Is stored b©cfe«ai*t* 

in core.) 

BUILD -The BUILD conrasj^ia*tia«B%e0» Imaga-aeavafalsa. It muvt.feafJur 
CIC cotaiaand. jSBj and IIIM -spsjcitfK- of&ional t^asry ta.puts.Bi «^3st**ay§s be 



ha ttfriaat- l@f te$l: -'{U*. 
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CIC Error Messages 



Error Messages 



CIC error messages are output on SL and prefixed by twc slashes (//). Error 
messages discussed in this section always cause CIC to abort, 
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n*MMIS 



MESSAGE 



MB/tf«!NC AND RSfifiEBiAi: ACTIOW 



'/CHECKSUM ERROR 



//CODE ERROR 



//PRECISION ERROR 



//END OF FILE 



//MISSING ROUTINES 



A particular card image element wtih>. the o>fi« 
modi'!* is e:tber missing, out of va-jence or was r.ot 
paadied pr»f«Hy wrien gtnerfct**. &*#*»«:«- *c 
object module. 

A curd image contains * twd tjpe co& **:'. feocstfiiA 
V* the C3C. IIS *»d sSS sufer^u^* U**d«c :•« «.-• «?c 
was processed. Remove tHe ot$ec* rnodbk frw. c*>r 
core image build. 

A subroutine object ir.odkifo iriwn :rop^- eithn A? *«■ 
SB has a precision cod* spectGcarior; 4if*««t ••' fw. 
that <>f tke MA5N program. CtV3nj?f !;•«» predi'w 
deft'tition of the objet! tv«>duL' <>' i.-iduo* <:':<• co»?c.- 
object module. 

An tr-d-ui **k ***:• fHcountcf^iI on e'-eh*? t?-? I? <*■? 
CI file AHoc»t* more »?<>rag;r for the workng fc»'-. 

This mestaft U output follower vj» s Uti =>* rfw *»fe- 
routiiifs referenced but not included Ik wsy of tW 
specified input fiJct. In-.ttui*- thv rtqvbed -jH-j" 
modules and restw* the core twiajs belli 

A card image record wnich did not cotttsin an aste?j*i 
in character positio?'. ! was encooilered before tke 
BUILD dsrectiv? Include or correct C:C CanticA 
Commands. 

The piograr:i being 'riiit is too large ior the specified 
tore ares. The ^arsmc-ters specified Oft inf. BGvf^D 
statement re»y be changed if used. 

CIC Operator Messages (for paper tape input only) 



When the CIC encounters e $R££L record the following rnessaqe is output o- 
logical unit OM followed by a type -in request.: 



//CC ERROR 



/'KANCi : ERROR 




//fiEEL 

? (in out r-„ j au3st) 
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2 • 5 • 4 SOURCE I M AGE EDITOR 

The GA 18/30 source image editor is given the name EDIT in the DC file. Thus 

it can be loaded into core and executed by the use of the control comma d . 



$EDIT 



File Usage 



The following files are used by EDIT, 



51 Source input 

SO Edited source output 

CO Control commands and insert lines 

LO Edited source list 



SL 



Control command list 



Control Co mmand 

Control commands (identified by »n "«$" ?..'i "bo first character of a line) and 
Insert Lines to the source deck are alt input ftom d',ivtc-3 CC. Blanks era not 
permitted in Control Commands. In the description below, optional elements of 
a control command are enclosed in braces. 
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A file to be edited Is Input via device SI. SI may be assigned to the oard 
reader* a directoried so««* file (BS, NAMtror* user file. Format: 



$SI»CR 
$SI»DS (NAME) 



$SI«*flie 



(name) 
(be-es) 



Editing commands are input from device Qg,"iMt£MUy the fT5f keybo«?d. CC 
may be assigned tee device other tftaa &te teletype but may not be «a» device 

assigned to SI. Examples: 



If SI - DS (NAME) 

or * file (name) 
(bs-es) 



$CC * CR is permissible. 



then 



teiwi.lnfHiiiff 
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1 Editor Control Commands 



r or the fcilcwing, the character "Y" or the character "ft 

"-'' character. The character shows* is the d-ii^ut : . oesy, which v/ilJ b«- 

assumed upon entrance to EDIT. 

@8 2 -'<' Insert bisnks 



j 
For 8~i' , the generated souroe output will be preceded by 20 blanks , thus I 

permitting the assembler format to b© generated without need of spacing , ] 

j 

Data already having the. leading 20 blanks tvilJ be passed unmodified. For 1 

B * N, the records will be passed unmodified. j 

@OM Online mode f 

Fes- 0»Y, the On-Ltne mode will be entered, with the additional editing 
controls described below. 

@L«N List control 

Tm L*y, the full Edited Source Output will m listed v&il® focL»H, itmif -f%' 1 .. * 
e|tgg$$®« #f* .listed. * ! v> r '|l 

1 

"i. ; /'V ■ ' " ? 




mmim. AttmMATxm, whl - .^j .. !■ '■ ■ ■ i :;n ^ WryiViipjVT- > , n, . 



@$*Y Sequence control 



•**• 
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For S-Y, the listing will be resequenced while for S=N , the listing will reflect 
the sequence number of the Source Input. 



Y 

K 

N 



for OY, the balance of the tource input is copied to the output Hie. ffer 
-4Hi» Hm» output file is terral&atad at S*e GMraat.fMttlaa. #" 



On Line Commands 

When in the On Line mode, the following two additional commands may be ueed. 
In addition, the line reached by an L + n option or by tha following two options, 
will be listed: 

#► Delate the current line and advance to the next. 



Copy the current line and advance to the next, 






»0. 



r 



■ V-Pg^ 



i jitujtifttomii i . i i i n. 



iMi- 



£ 



, 4*4 




settm&i Auwmjkrim^^ ^.^mm ,, ■ . . -*£*&**■» *—*#*•**• 
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Editing Commands 

'■■ ..-J ■ ?s -J. ■■■ ■ '. '. ■ '^'■'»»«j- . -. ■■-"■• "• 

Ail editing commands esoeffc *h© 1XmvW&m'®p#m*&& tmym'Sti^e^W-***' 
or more lines to be Inserted at &m. cwarent p©s*f iter* ©i the topu* ^esseid. 

•HMD-] 

@ Indiis&tes lias tSrSpBBpste^ _-^ - ' .^ -,..., 

. L is a 1-5 character label, 

n is the count of lines after L has been reached. If L is 

omitted, n is an absolute line number with the first tine of the 

program having n=i. 
ro is the number of lines to be deleted. {.Assumed to be sero it 

omitted.) 

In operation, the source input is read and copied to the output file until line 
L + n is reached. Then if m is specified, m lines, including the currant line, 
are deleted after which any inserts are input. If m is omitted - the line 
L ♦ n is copied to the output after which any laaeris are input. 

Editing example s: 

Assume a freshly key punched deck is to be processed. The operator wish®*' 

t© list his deck, with sequence numbers, make correctiors and th&n assemble 
his program. 



: 



I 



t 
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SJOB 

$COPY,CR,DS(NAME) 

$SI=»DS(NAME) 

$EDIT 
@L=Y 

<&C=Y 



Place source on disk 

Editor source input from new file 

Call editor 

List all 

Provide line numbers 

Copy DS(NAME) to WS to produce 
a sequenced listing. 



At 


this point the operator may punch 


an edit deck 


or edit from the telety 


'pe. 




$CC=TY or SCO 


=CR 










Ed 


iting procedure examples: 








- 




To 


delete a line at label +3 the 

(a].ab<=>-3 , 1 


eriit 


command 








To delete n lines at starting at 


line 


number 2384 


the edit com 


mand 






@+2 384,n 
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To add a line @ line 200 with no delete the edit command 

@^200 

data to be inserted, may include leading blanks. 

NOTE 
No leading blanks are required because *'B" edit 
command was * Yes. 

To delete m lines starting at label + n and then make insertions the edit 
sequence would be: 

©label +n,m 
data records 

data records 

etc . . , 
In all cases the master file OS(NAME) is copied to WS until the to be edited 
line ^ fct encountered . At this point the edit functions specified are performed. 



Y 

The last record input from device tJC must be an @C^ command. 

— N 



"PWWW^MWBWjWi 



■■■■s ; i 



.J 
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This operation will complete the copying of the eource file (DS,<NAMfc)) '& ;1j$, 
A new sequence listing was produced during the edit operation. The ppeca*fir€B|ip.-: 






$SI*WS 
$IS«NO 

l$BO«No] 
$A 



assembler s^nsrce from edited file 

No intermediate storage required as source is already 

on disk 

No binary output. 

Gail assembler 



alter the list status any time by #1* , At this point the user may ..M0**iitt&?U7^ 

n ., ;;|. 

his program to determine any additS«iel source er*>rs. This may be 
as follows: 



*<* 



■.. * 



„•";. 



The operator may now edit his source Hie further. If editing was accomplished 
from card data add the necessary new edit cards. Call the editor as above. 

If editing was done from the TTY two alternatives are available. 

1 . Reenter all edit commands plus the new ones via the keyboard , 
^2. Copy the partially ed&£f-#« l f&&k & tSSfHAME) . The listing produced 
during the previous edit would be used for reference. 



Z o 5 . 4**8 




Qtm*AL AtfTOMATiCM, WC, 



R8A00I42A 



Example: 



SREI'LACC , DS(NAME) , WS 

SPACK , DS 

SEDIT 



Edited tile to DS 
Compress disk file 
Start next edit. 



The card edit procedure is preferred. This method maintains one master file 
(that which was originally copied) and an edit deck. Recovery in the event 
of mishap is positive and simplified. 

Once a source file has been totally edited, it should replace the unedited file. 
Refer to example above . The PACK operation closes up the disk file by 
removing the old source data. 



V>v*v v 
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2 • 5 « s DgBtTG PROGRAM 

The GA 18/30 Debug program is given the nam© D in the DC file. Thus, it can 

be leaded into core and executed by useo! the command 

$D 

Typically, however, the DEBUG program is loaded In conjunction with a program 
to be debugged: 

$LOAD,D Load the program in the WO Urn and load D. Execute D. 
$pname, D Load the program given the name ! pname ! in the DC file 
and load D. Execute D. 

DEBUG uses the following logical units: 

CC command input 

OM listing output, error message output, secondary command 

input 

LO listing output, command output, error message output 

CI binary output 

Debug occupies approximately /7GQ locations of high core origined at /7300. 
Programs tc be debugged must not occupy storage above /7900 (truncated to 
to raflact available core) . 
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COMMAMD FORMAT 

A command consists of a one-ietter operator and one or more operands. Multiple 

commands may be placed on a line. The slash (,/) delimits commands; the comma 

{,) delimits operands. No comma should fo® placed between the operator and the 

first operand. A space terminates the last oommsisd, optional commentary m&y 

follow (for teletype input, a carriage refeira terminates the command lm<&', no 

space is required unless the user includes optional commentary.*, Example* 

Command Operand, Operand . . . , Operand/Command „Oper, , . ., 

OPERAND FORMATS 

The following are the possible DEBUG operands: 

i. Addresses/Constants 

An address/ con stent consists of \ - 4 b.exidecimai digits, written as 

/nnnn, with an optional modifier of R,X,L t PorS, If more than four digits 

are input, only the last four are considered; non-hexadecimal characters 

(other than modifiers) are ignored. The modifier may be placed anywhere 

in the digit sequence and has the following effect on an address (not 

applicable to constants): 

None Memory address 

R Register buffer address 

X Disk buffer address 

L Limit buffer address 

P Program relative address 

S Sector address 

The S modifier is not allowed for certain ooerands r 
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Examples of operand addresses are; 
3A location /3A or constant /3A 
R3 register 3 

3 IX location /31 of disk buffer 
AS6 sector address /A6 
P43 program relative address /43 

2. Address/Constant Field 

An address/ccn stent field is of the form: 

a. A pair of addresses/constants separated by a dash. The modifier 

of the second address is ignored (and may be omitted, it is assumed 
to use the seme modifier as the first address), 

b. A single address; may be used when the first &nd last address 
are the same, 

c. The letters R,X, L and P are fields which are defined as follows: 

R « RO-6 

x = xo-nr 

L - {contents defined by user)L0-i 
P * contents of LG~contents of Li 
( Any reference to the letters R,X,L or P without an address constant 
is interpreted as a reference to tti& entire field J 
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In the text which follows the lower case letters a>ca,rf,f,k,kf denote: 

a address or constant, S modifier allowed 

ca core address , no S modifier 
f address or constant field 

cf core field , no S modifier 

k a 1-4 digit hexadecimal constant 

kf double word constant 
Refer to table A. 
BUFFERS 
Four buffers are accessible to the user. 

1. Register buffer. When control passes from the user program to the DEBUG 
program, the register buffer is set as follows: 

RO Instruction counter 

Rl Index register 1 

R2 Index register 1 

R3 Index register 3 

R4 A register 

R5 Q register 

R6 Cany and overflow (bits 14 and IS) 

2. Disk buffer. This buffer holds one disk sector (320 words) which can be 
used as a work area for disk modifications, 

3. limit buffer and Program buffer. The limit buffer (2 words) defines the 
limits cf the program buffer. (L0) is the low program address and (1.1) is 



A '} 
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the high program address . Proper definition of the limit butter allow* 
relative references to relocatable program addresses. The limit buffer 
is normally defined by the replace command; e.g. , 

RL, 1092,2301 Low program buffer limit = 1092, high-2301 
then P0»/1092 and P {buffer) =P0-12€F-/ 1092-/2301 
A reference to PI 00 would give the value of relative location 1192. A 
reference to P by itself would refer to a field defined as P0-126F. 



Miiiii»iiu*uiriiiiiinft 
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DEBUG COMMANDS 

Table A indicates allowable DEBUG commands and their function. Items in 
brackets are optional. The notation { . . .) indicates that the operand serene* 
may be repeated. A more complete explanation of each command, along with 

examples, is given below . 
1. Type 'T* 

* 

Tfj,f 2 ...,f n 

The Type command causes the contents of each location within a field 

to be output to OM . Any number of fields may be specified following the 

type command. After output of ail fields is complete, the user has 
3 options: . 

a . Enter a new command . 

b. Enter a carriage return (blank record for card input). The successive 
location and its contents will be output, i.e., if P52 was just 
output, P53 would be output. 

c. Enter a hexadecimal constant. This constant will replace the 
contents of the last location output; then the successive location 
and its contents will be output. 

Opttons J b' and 'c' are available only when; 

a. The type command is the last command of a sequence e.g. , 

P37/T36,47,R3 (Print location 37, Type location 36, 

47 and the contents of R3.) 



=J 
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At this point R3 and successive locations can be modified. 
Options 'b' and 'c* are net available in the exempli below 

T36,47-A1/P52 ,.- v - 

P refers to a coinmand and is recognized an latt command because 
slash delimiter was processed, 
b. In the following exempt e the letter *P' denotes a program location 
and may , tnerefore , be modified . 

TS3,P4 (Type contents of disk sector 3, ami relative 
program location !.) 
An oxcepUon to die last item may be changed opUo: 
exists if the last itemr«f«rred to was a disk location Example; 
TP4,X3C,K3,S25 (S25 refers to disk sector 25.) 
PRINT *P' 

The print comn.and causes th» contents of ea;;h location within lie field 
to bu output to LO. No subsequent modificat on is allowed. An example is 

P30,R, 3306, 500-800 X4-9.P 
which will pr nt absolute core location /30, <:he entire register buffet 
disk sector *06, core lo;ations /500-/S00, locations /4-/'* 'A th«- 
di»k butrer, ..nd all of tb? program buffer, To print pro-am buffer 
location 30 tie con-. mam PP30 is required. 
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3. REPLACE 

Kf # )c j #^2* * • * n 

This command replaces the contents of 'f with the pattern ,kj ,k« • • • 

,k . if the pattern is shorter than the field length, the pattern is 
repeated until the field is exhausted. (If 'V is a sector field, the pattern 
•is- expanded into the Ulslc fcurffa* (328 words) and tne buffer is otatput to 
each sector tn the field.) II no pattern is supplied, a pattern of is 
, assumed. An alternate form of the replace command ist 
Rca, ki ,A2* * ' '-q 
In this form, one copy of the pattern replaces the contents of the locations 
^ftarting at 'ca'; Examples of the replace command are: 
R61 Zero location /61 

RX Zero the disk buffer 

RS90-3 03 Zero sectors /9 0-/1 03 

R8(M Replace location /8G with /4 

RL, 10S7, 1A32 Define the limit buffer 
RR0,3 Replace register with 3. 

RX, 1 ,24, 8 Fill the disk buffer with the repeating pattern 

/i,/24,/8. 
R83,A2,B7,C4 Replace /83-/8S with /A2,/B 7, /C4 



ewivuBJSw.^tdr «M3Si> , '-ft* " 
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MOVC 'M' 

Mpj ,p 2 . - • .P n p : =fj,f 2 fj^sending field. 

Move f^ to f 2 . If the sending and receiving fields are both com or both 

disk, the receiving field determines the number of elements to raovs*. If 

one field is core and the other field is disk, the core field determines 

the number of element^ to move. Date movement starts from th® low 

address. Examples of the move instruction are: 

M70, 80-AO Move locations /70-/9G to /8O-/A0. 

M70-500,8Q-A0 Move locations ,-'70-/90 to /8G-/A0. 

(receiving field limit control) 
MP,S501 Move the program buffer to disk 

starting at sector /501 . 
MS501 ,P Move disk starting at sector /501 to 

the program buffer. Preset limits with 
RL,l p l 2 
MS10,Sll-20 copy sector /10 to sectors /ll to /20. 



Noto: 

The command MS5.S11-20 will copy disk sectors starting at sector 5 

to sector 11,6 to 12,7-13 etc. 
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The command MS 10, SI 1-20 above copies sector 10 into each sector 
from sector 11 to 20. The key point here is that the source sector {or 
core location if moving core), is only one field length below the destina- 
tion area. Each successive move or copy effectively copies the same 
information. 



5. EXECUTE/TRAP 'X' 

X HMNK 

The X command format provides the operator with program entry address 



/c N 



selection, trap address selection, trap loop count and execution control. 
The X command initiates program execution by placing the contents of 
registers RO-6 into their hardware counterparts. The value of R0 re- 
places the instruction counter and is therefore the point of execution. 

To specify an execution address: 

RRG,a Replace register R0 with execution address 

X Execute 

The X command may be written as part of the replace sequence, 

RR0,a/X 
To set up a trap condition the X command is followed by one or two para- 
meters. 

X , ca , k 
Execute from core location specified by contents of R0. TRAP at location 
'ca' after 'k' encounters of trap location. If 'k' Is not specified one is 
assumed. 
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After a TRAP is encountered register RO is equal to the trap address. A 
subsequent X command will resume execution from the TRAP location (ca). 

A series of Debug commands may be specified to be executed each time 
the TRAP is encountered. 

X.ca.k/c^'c,,. .../c n 
After TRAP at location 'ca' execute specified Debug commands cj,c 2 . . .c fi 

The command sequence is executed before the trapped instructions are executed. 
When control returns to DEBUG, RO is defined as the trap address, the trap 
locations are restored, but have not been executed. The following rules must be 
followed in selecting a trap location: 

e. The contents of ca and ca+1 must not be modified or referencec 

during program execution. Control must pass to ca, not ca+1. 
b. If the trap execution count is greater than one, the trapped loca- 
tions may noi: be instruction counter relative (the instructions are 
not executed in place). Also, the command sequence may not 
contain an 'X' operator if k is greater than one. 

After an object program and debug have been loaded ($NAME,D or $LOAD,D) RO 
is set t& the entry point of the loaded program. Execution may be started 
immediately by entering a X command to debug. j 
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Examples of the Execute/Trap command are: 

X Execute at RO. 

XA53 Set trap at /A53, execute at RO. Return to DEBUG 

when lite trap Is encountered . 

X62, 5 Set trap at /62, execute at RO. Return to DEBUG, 

after the fifth encounter of the trap. 

XA32,A/PR/T54 Set trap at /A32, execute at RO. After each 

encounter of the trap, print the register buffer and 
type location /54. Return to DEBUG after the trap 
is encountered /A times. 

X104/PRA32,'T80,R3 Set trap at /104, execute at RO. When the trap is 

encountered, print the register buffer. Set a trap 
at /32, execute at RO (»104) . When the trap is 
encountered, type location /80 and register 3. 

6. SEARCH 'S' 

Scf .kfXk^j Search for kfj , 

The search command searches cf for k'f j . Each match is output to OM . 
If k£2 (a mask) is supplied, kfj is compared with the logical product of 
cf and ^2' e l^ ment by element, kf, is a single cr double word constant, 
A doubleword constant is of the form k j-k2 where k\ is the high order 
word. Similarly, kf.-, may be a single or doubleword mask . 
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\t kf 1 is a doublewonj and kf 2 is not, then kf 2 Is assuired to be of the form 

kj-FFFF. Example? of the search command ere: 

S100-500,AR JD Search location* /100 to /500 for ,/ARCD J 

SP, 3781-4 5A2 Search the program buffer for the double- I 



word/3781,/4SA2. 
SX, i 57 , F7 F Search the disk buffer for /] 57 ,. Mask 

each element with /FIT . 
7. OBJECT OUTPUT 'O' 

Oct j j,cf 2 | . . . j, cf n J [,ki Object output to CI. 

Output the core fields in 54 word binary object Jorm;t to CI. If a core 

fie];: represents a single address, it must be of the torm .*, -a, , otherwise 

the address will be interpreted as the execution address fk). The 

execution address may appear anywhere in the operand sequence, 

If more than one execution address appears, only the last is considered. 

If the execution address is omitted, RO is assumed. The Dt'BUG buffers ma/ 

be included as operands, e.g., 

Ol 000-1 500, R,X 
or if L is defined a^ 1 = 1000 and e=1500, then 

Of\L,R,X 
At a future time "the $LOAD,D will restore the user program aid DEBUG 
buffers and debugging may continue. 



2.4..5-13 




mm®Ai automat torn, mc -— — 

88A00M2A 



This feature permits partially debugged program segments to be saved „ 
should the program be destroyed duriag debug .of the next seg m&nt a ■■• . . jj 
simple reload of the patched program is possible. The program may be f 

i 

stored as a directoried file also. ($COPY,WC,DC(NAMB)) In this a&m I 

l 
$NAME , D would be used to reload . 

8. SWITCH COMMAND INPUT. 'K' I 

I 
The K command switches command input from CC to OM or OM to CC . I 

| 

This command allows program modification commands to foe puncned on i 

I 

cards or paper tape; by using K as the last command , control will pass \ 

I 

to OM (normally the teletype) to allow further modifies lions.. j 

1 

9. RETURN TO DBOS. 'Z» ! 
The Z command terminates the DEBUG program by returning to DBOS,, 
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OUTPUT FORMAT 



f rT'BU'T- rioted line has the format 



1 oc*=d sid: d. a ta 7 , , , o a la 



L 



loc 



rens'sssnfcs the location 






let is o." the form 



Xhr 



core a a are £ 



rac istfa* address 



di :■:■!< buffer atidr 



l.h 



limit buffer sddre: 



Phi 



program ralai'tv« addres 
/FIT thf ; modifier merer 



. ; 3 1 ' v'3 '? C 



aata 



n 



r^Tfisen 



!T3. i.i^r: 



:./:> arc 




AvrcmjtTfoa, mc. 






TdtkA 



Pfj|.f 2 |...|.t n | 

R»|.k 1 ||.k 2 l...U M | 

K 
Z 



ea 



.»' 



kt 



^©iltfwt to GM, allow cfcaagas- ■'-• 
Output to L? 
Replace f with J-tkj } ,Jij| —i^J 

'. Itese i | '*» r fcf. ; . ; '. - . 
gsectste «««»! trap (C«CQSs«WM»i> 
Seafcli f for kf ? witfe trow* kfg 
C&jec? oatpsH, fc*ea«>cs*&»n address 

* Cts*nfs command input 
Return to DBOS. 



Addrets/conatant. address may feavc modifiers o£ 

Core adores*. Same as V, but $ taodUWar 
not allows^ 



k A constant 

f Addrcss/co««ant field of toe form a 1 - *2> 

a. orR.X.L.P 



Core field. Same at T, but S modifier 
not allowed. 

Constant field of the form k or *-j-k 2 
(dottfcfeword conttanl) 
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I. 5,6 SEQUENCE/COMPARE PP.CGRCM 



The GA 1 B 



'.; o^j ' ;; y ''-'. '. i ,*• 



ThuS . 



tl- f' C 






a : f i ' 



v-mere, 



f*. 



C'i t : ; :■.-.'■ r i ' 



If '-' 






fM 






.... [SLgmJI $ <&m$%Al JU(T0m£nc&; ##C. .,„.- 



t 5 

* J 
5 i 

\ 1 



» 5 






f 1 

f s increment \ 



£&vS0l4£,,« 



A positive v«%!«€ of any size v-hich SQCM wlli us© f* in- 



crement ihfc base. 7i V;.r iri^'M*^; is «v%c:ift«€i 



<vU i use xTie numeric 



^.'3" 



r'Hl'n^^ 3 C 'V;.:--. 'ii'lC 






't < 



-- 1 vv < a 



1! 
1 i 

t 1 

v a 
s I 

! 8 



i i 

i I 

i i 

ii 



umc' 






U *U" ; » specified and the ,r : 
o?if"pv;t mode is 'i-^ s-csTi',^ ?'.s ' 

;iS S'J.f.VSCi . 



S i 



i. -/s; 



3CX 



.. v 
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Error Detection ana Correction 



HftAGOHZA 



jn com oar© error, the correct J mayo wiU be output u 



md the toossace ERHOK 



will be output to CM. Th* correcr ima<?e w 



n 



TO Si ffVDd'i- *;>',! •.."/ Sfa'.IUBnC-^ 



I 



•?raticr 



f>r:'i Si*i>:-Y 



j,. ». r* at 



■'Oi O'.j.;'.-! 



au o< 






A tvo 



iA!l? hS 






-\n. of the file 
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SSI^HJ.jSEUiiSSSSS in sert ion s 

Any number of ASCII records may precede the SQCM command (>) . Theses r#cerds 

will be copiad to or compared with the object file* The in sorted records m& not 

sequenced or titled. This feature permits annotation or control commands to- h® 

inserted prior to the ob1----t d.ita. 

A special termination procedure is provided if only insertions are desired* 



SQCM 



Insert 1 



Insert 2 



Terminate job after Insertion number 2 



Examples of SQCM Operation 
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s.*«ptES c-f %ec* usage 



ASSUME k BINARY TW.Z IS ALREADY IM &C FSOS3 C5C 
TO GENERATE A S£OU£*4C£D BACPCUf 3 08J£CT OCCK DO 






SSlsriC 

sso-cp 

SSOCM 
»NAs*8gl « 6 



iMpyv r»OK vac ' 

CALL 'SOCK 

WAW£ P$06&Att NAM* S£0 F»©?1 1 ST t$ 



TO ¥£«JfV OCCK 

CO*f**f*£ IW'^UT PROM C*8& R£*ft£K 

CALL SOCK 

SVPSH.Y SAM£ Sf Gt<C**f f' CC";TKOi AS ABOVfc 

CO»8CCTlONS» fr A>« » »?l l. g£ OUTPUT TO €*» 

to seoupucf &*^ fessf*«airs ew Fortran sck/rcf rue 

INTO CARDS *«0 V£:«?F*. 



SCQPVtC 5, ws 

SSI =WS 

$so:m 

SS<5~«G 
§SOO- 

»TiTtFee6«**so.A 

&?ItLCO0ftO0»8O»A 



"5*0?* CA^Ih V i ■ Vf$. 



SOUSC F f >-•' *» » S 

s£S!<'» Fltl"' ?' ? DElfsKOs AND LIST E^SOPS OW Lr* 

VERU'V SOO&f.C fJLE OJSs, ItfA&S. 

SEOUFNCE OUTPUT to CJ- 

CALL SOCK 

f'JVfe CHARACTER TITtf. f"IVC 0162? S£0. «€*s IMf,SlS 
INPUT S|tL TJ-RWINATf: 0*3 S0-JSC£ ?'!!_£ 'Sf-JC" STATCKi'NT 

CALL SQC*» 

COttPARf DECK TO FILE OK OJ.SK WODIFiED 8* SEC t»A?A 



i '■ 



I > 
I s 



i 



TO PRODUCE A TITLED fiWf; SE^UENCFD CaRO OEXK AFTeB 
A rG»THi»?« roMPIL*'? tOU *?«:> 80110, 
SJ08 

*r _-«—___ „„xattH±Li._8»Axt!»Laj!t£ . , 

IS3U8CE STATfiENtS ?0* OPTIONAL SUft-PfUTSftftM j 



MO!) 

*s4AP 
•BUILD 

SISsCT 

*$QCM 

*?O»00000«l0»8 



ciosc *»R rn.c 

BUILD C0«£ I MAG* 



: !L£ 



COMPARE SACK'JP DECK* COKKf CT 10MH TO LP 



( i 
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SEQUENCED SOURff riLf WHICH INCLUDES 'SEOO* RfCO^D 



8SA0QU2A 

TC ASSEMBLE a PROGP*«i ftwo PRODUCE * SEQUENCED BACKUP 
4 - T.km 5ECK WITH TITLE AND VF8IFV. J 

SSJaKR JNPJT f»OH «B WHICH IS *Sn OUTPUT 

sso^cp sequenced output to cp 

ssscn call sqc»* 

»yit(.000!«9 supplt seg ano title data ♦ fopwat 

$|S=CP SET COMPARE fP.'jM C» 

SSOCM CALL SGC* 

»TITL000!,B SEO ANu TITLE DATA • FGHXAT | 

I 

I 

] 

5 TO SEOUfNCE A SOUPCE FILE CONSISTING OF MULTIPLE I 

STACKED JORS WITH M*NY *ENn* STATEMENTS TO THE CP, { 

s 

s 

sjo« i 

*si=cfi unsequenceo soupce f<?o** c# 1 

SSO=WS SEQUENCED SOUPCE TO WS j 

SISsNO SEOUfNCf/COPr SWITCH I 

SSOCM CALL SOC* I 

> T I TJ ,fiJiaiLUC„-_ -I1HF ., t ,-l&t.H OtZSIAS. I JUSBLiBStlJaMfl * 

$€00 TEPNINAtE FUE Ts fveEC U^OPMTn'ED DATA 

$COPy,c.w%"-P PUNC^ Ca«D DEC* f»0« SEQUENCED r!tE« INCLUDES SCOO 
*5l=*s seen compare *6$Tt"» 

*SO=CP SOC* CnoHECTIO'^s TO CP 

SJSsCR SOC* COMfftPE FILE 

SSOC" CiLL Sr.'C** 

COMPAWF AS C FORMAT oatS 



(MOTE -> TNf SEQUENCED FILE IN tfS IS NOT LISTA*ir.E. 

TH£ SEQUENCED CA«0 OECK MAY HE LISTED wITh i SEPIES or I 

COPY COMMANDS* ONE FO*> EACH JOS. THE r;fCK **r «?£ J 

STORED AS A Sf» IE5 OF J08S FN OS. 3 

M?T£i SMsr »hs L £ THE sshOLE FJLf has *. CONTINUOUS SEQUENCE WO. I 

H STILL CONSISTS OF HaNY INDIVIDUAL F?LES S 1 H^ FILE "«* f 

SE COPIED IN € *"0»M*t BUT *av wot BE j 

>TOPED IN OS IN C F0R«6T. & SE&jES OF COP* CO*****!)-:, I 

fS PFQuI»EO TO STO&E THE ril'C lh A FOK*M SuIT*P.lE Fft£> 1 

LISTING 08 TNPul TO THE PROCESSORS. I 

| 

*COPY.»C«KC*Cf0C« I ITS I COPT D&Ti AS C FORMAT 0STS I 

SCOPV.C^WC.CP COPY C fOPMfcT DATA TO PUNCH I 






I 



J 
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TO *SS€M8t£ * PROGRAM* P90OUCE * SEQOEMCfD 8£C*UR 
C£RO DEC* WITH TITLES AND VERIFY * STORE IH DC FH.Z 

SJOP5 



jsOURCE'sTAIEwfNTS* LAST RC CO^P. WU.$T..Bg. AW JEHQ*. CAMDj j 



SSOr*C 
SiS~NO 
SSOCrt 
vTITtOOOO.J' 



SOC* INPUT fSQM WS 
OUTPUT TO WC 

nto*/cc'p? 

CALL SfaCM 

TJTL AND SECU. INC. =1? BTWARlf 



*COPV»C*WCtC«DC<TITL* STOKE SEQUENCED ImA<& IN DC FILE. 
SIDIR.DC 

SB5=0€«T?Ti.» 

SSGCM 

*e 

SCORY«C**C»r.?> 
5t5 = C<? 
♦SCCH 
^TITLOOOO'l vB 



CCHPARE oc nut T& 88 



OUTPUT SEOUCKCEQ 81M*SY SACK?** OECK 

conpape tc c« 

CALL SOC* 
C>0 COMP4R£ 



TC CORT *,NO VE»5. r T 9 PAPf.'S TAPE OF ANY FORMAT 

TO hC 

CORY UNFORMATTED O&TA TO OJSK 



SSS-PP 

*SOr*-'C 
JSQCN 

fISsWC 
&SOCH 

SISsMO 
SSQsRR 
tSSsSC 

*SOCM 

*soc« 



VSR!*"* fiJSK FILE 
COP? W€ f%i.J, TO PR 

v€«!fr pukc^ed tap? 



THE D5SX JMAGf IN *C CAN St STORED AS A ^JtftECTORlCO FILE IN 
OC AS SHOWN BttQ^. THE DATA IS NOT EXECUTABLE IN THB FORM 

however, this psov j s i oh ss for storage o*«u 

»CO»T»C»*C*C*DC*NAME> ii«F0R*£?rrCe TAPS TO DISK FILE 
TO RECOVER THfS F;"tE AND PUNCH A PAPER TAPE 



£«0*RR 

**U 
SJSsRR 



TO PUNCH A 9ACKUR Biw#ev PAPER TAPE *.N0 VERITY 
PUNCH HEW TAPE FROM OC FILE i^AMCs 



Viffirv *E# TARE. If AN E»»<JP OCCURS T*E TTY tffU 
If RE •ERROR*. RETURN TO MOKITOR CENTER C £/*. 4 »*5£ 
RETRY VERIFY OR ®5J«Ck Nf.« TAPE*" 



! i 



1 ! 



1 I 



| 
| 

11 
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2, 5 c 7 SY5TKM GENERATION UTILITY 

The System Generation Utility is designed psl^-rsly for irv.rH.* system e©nG«iynsnV ; 
and building* as described in Sac'ion 4,0, oYSGaG however is al?o u;'6Gu ; <>* » 
utility routine Used as a utility many system dmract?*; ;S"Uo;. ^ey b-n ?Gn nnvG 
All redefined parameters becoma ed'.t'ecUv>? ur-rradifttsdv upon, return *.-, «.h* Monitor. 



The GA System Generation Ut.x.Hty is given the n*s:ne SY3GN in thy s~*C file. Thus, ( 
U can be. loaded via the comr.^ncl; [ 

■ 

SSYSGN I 



The SYSGN utility inputs commands expressly designed *o erse the osnerasdon 



procedure , The Dob 






included in S'/SGN en; 5 fs described 



System Generation Commands 

All commands are written in standard DSOS format as described in Section ? 2. 



Di sk_ Unit As signmen t 

; whore unit is one of the ioiioWrng' 

1341 - Mooei 124). Disk Storape Unn 

1344 - Modei i344 Disk Storage dnii 

1345 - Mode- 1345 Dish Storaae TGh 
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This command establishes the proper code in BULKN to handle the specified type 
disk. This command would not ordinarily be used in the utility mode. 

Core Size Assignment 

$CORE,slze 
where size is on® of the following: | 

! 

8K - for 8192 word memory I 

i 
16K - for 16384 word memory J 

32K - for 32768 word memory j 

5 
I 

This command establishes the upper core address limit for many programs which. 1 

execute under DBOS. The input value must reflect the actual available core in j 

I 

i 
the system. \ 



Disk File Limit Assignment f 



i 



> 



where: I 

I 

file Is the name of a disk file as shown in table 2-2. j 

(bs-es) Defines an area of contiguous sectors to be allocated tc the 

i 

named file. The values bs and es are specified in hexa- I 

i 

decimal, j 



I J 



t_ 
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This command is especially valuable when a currently defined file structure is 
found to be inadequate. Caution roust be exercised when redefining files to net 
overlay a previously defined file. Typically, all tiles which follow the file to be 
redefined must also be redefined if they are to remain contiguous, A file may be 
redefinad to follow the last previously defined file; however, the space vacated 
is frequently wasted. Sectors D-FF ara reserved for system us®, Tha ordering of 
disk, files shown in appendix A has been selected, to- minimize seek Urn©. ;t is 
preferable to reassign all files following a specific file to preserve the indicated 
order. All moved files must be rebuilt 



I s 



I I 



} Imuajiize_DisR 



ESDISK f,bs~es 



X" "~j 



s 



-h* 



where bs~es, if specified, are the beginning and ending sectors (in hexadecimal) j 
to be initialised. If the optional limits are omitted., the entire disk is Initialized, f 



Those sectors which are initialized will be cleared of all previous data and 
addressed. Each sector is verified for reading accuracy. 



I 



An accuracy failure in a sector marks that sector as a "bad Sector". The bad « 

i 

sector and its alternate are logged m the bad sector table., locations /66 to /6F | 
of die Monitor. The bad sector table may be examined by use of the Debug routine, \ 
The bad sector tabic consists of word pairs which contain the bad. socio: and its f. 

alternate. A value of /Ff'FF./FFFF is used for unused word pairs . ) 



R a vised D®c 70 



*5> e •? 




osm®M. Mtmtimmm, tm. 



SSA00142A 



Define Initial and Standard Logical File Assignments 



HH5!^i!l2 (bs-ess) J 



This command is the same as described m Section 2.4.1 except that in SY'SGN, 
th© system basic definitions are established. The define file command in SYSGN 
is used to establish the disk resident iun/fiia assignment table. The tabic contai 
two assignments for each lun. The first assignment is in effect immediately after 
an initial system load from disk (IPL), The second or Standard assignment goes 
into effect after a JOB command is processed. 



ns| 



Procedurally, all Standard assignments must be made prior *r, the initial assign- 
ments. The or. - -nl to dot' mo n standard assignment also ..;<::. nes true initial 
assignment. Generally, the same file assignment is satisfactory for both the 
initial and Stancard condition. In these cases, only me .'tie assignment command 
is necessary. 



Example: 

$5L=LP,P Standard and initial assignment is to line printer. 

To force a special initial file assignment for a lun 

$SL-TY initial assignment ts TY which overrides previous assign 

ment of LP. 



.5.7-4 



Revised Dee 70 



fi 



I"™"** \ Jfg" ,* 

> 

| Copy System Execuayg to Disk 
^ ____^. .„-.— ~ —,—.—--. ... 

|^£tliliil jiliir 2- ®™^ 
This command is a special form oi tfte copy 



v y s ,!i4.;;% 



i m <Y< V; ! ?. 






#." : .*?'■';£ -v,T "'•*'& * I 



! to the disk. The parameter fue., ;ru« m a disk, file 



S /12-/27, 



uxamoie: 






tFYFC PR 8 



^ n^r • ^ tiP 1 



| Initialize Qi£^?^? r \!!£L 



$IDIR,f:l( 



where -lie is a itrector 

The purpose of this cot; 
This command is. u sea * 
file, T;ia alternative to 
for all entries in the fi. 

$D 

This command invoke; 
In SYSGN is to par nut : 
command which nocrsiel 



::n Ci j.ii C.2Sf ;i. CVJ 









t tsptsv-t; 



, L£,Ui 



'.'L covnmaad 



ae desert 



il= s lO 'llify Mv"'^"':" ' ' i. 
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Write Monitor to Disk f 

gWMON | 

I 
This command writes the system bootstrap and monitor to disk. This command \ 

must be executed prior to returning to DBOS , \ 

i 

Initial System Operation | 

. _ , j 

SSIftBI I 



This command transfers control to DBOS, Ail modified ops made with any oi in a i 
SYSGN commands will be in effect immediately. | 
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2-5.8 BOOTSTRAP LOADER GENERATOR 

The Bootstrap Loader Generator is used to general© a card or paper tap® bootstrap 
loader for stand alone use. The operator may precede the generation of an object 
deck or tap© with this routm©. This feature la ©specially advantageous to paper 
tape users. This loader recopstses type codes of O, A and F only. The assembler, 
Debug and core image converter outputs may be loaded. 



i 



t • 

I j 
i 



; 



> 
" i 



The Bootstrap Loader Generator is given the name BOOT in the DC file. Thus, it 
can be loaded by use of the command: 

$BOOT 
BOOT uses the following logical units- \ 

SO -' data output 

15 - generate/compare input switch 

OM - error messages 

CC - operator input. 

Generate/Comp are Contro l 

If $lS»NO, BOOT will output an IPL format bootstrap loader to SO. SO may be 
assigned to PP or CP« If SlS^NO. then BOOT will compare the input ilia assigned j 
to SI with the correct bootstrap image. 



P t 
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! 

! Error Detection ami Correctler* 



l! 



I 

On comp©r« error, th© correct image is output to SO and ERROR Is output to OM > 
The operator must respond after an -arror wtih one of the following; 

C - conttawe 

R - reread image to double chs»«fc or veufy new image output 
when srrror occ%gr«d * 

D - terminate and return to fee DBC-3 monitor- 

2,5.8,1 Card Bootstrap Lgadgj .J^igSMllS!! 

The Card Bootstrap Loader may be loaded anywhere in core. Once loaded IV-' 

s 

!i 

S loader may be re-entered at location as required for loading subsaquard pro- 
1 gram modules- Care must be exercised to place ih*» rodder ■:, <■ n area of cer« w"3<d 
I will not be overlaid by the object program. The fcxecution/ioadiriq adorers iO* 

1 irmst be an even address.. 

» 

i 

l The following steps are required to load and execute the Card Bootstrap Loader 
»?, iocstion (Qh 

3, IPL bootstrap into location Q normally zero;, Q rust be ■■v*r 
a. Unlock the 'Console Enable' ar.d 'WSPB' switches, -q; ad 
switches off (up) except for '3dC lidLCd diALl and >'^.rd 
IPL channel (normally "Register Select' switches °> o",d 4), press 
and ratea ss f r&sst' , 



S 

I 

i 

! 

! 

j 
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b. Load card reader with 3 card bootstrap/loader followed by on© or 
more object decks. Ready. the c&pd reader. 

c. Set Q into the console data switches, press and release 'Enter', 

j 
set "|alt' switch off (up), prase and release 'IPL' (card 1 of the j 



i 
I 



i I 



bootstrap/loader will be input), sat "Half on (down). ! j 



2. Execute bootstrap at location Q with data switch options, 



l 

\ 
i i 



a. Press and release 'Reset', sot Q into the console data, switches, \ j 



i . 



set register select switches off (up), press and release 'Enter", 



I 

* \ 

b» Select data switch options I j 



! ! 



,< 



■j 



s 



Switch » load/execute option 

Off tt Load according to switch I 

On = Execute last complete object deck loaded. 
Switch 1 = load option 

Off = Load and execute one object deck 

On = Load multiple object decks j j 

i j 

Both switches may be changed at any time during the execution of } \ 

5 f 

j i 
the loader, i.e., if multiple object decks are being loaded. I \ 

I | 
switch 1 may be reset, while loading the last object deck to effect | ! 

K 

execution, or switch may bs set after the lass card in the "• 

reader is input to effect, execution . 



i \ 



i 



i i 

•i •. 
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c. Set 'Idle/run' switch to 'Run' , press and release Step' to 
execute the bootstrap/loader, 
3 . Errors 

a. Checksum error ci card reader error- Program will enter a wait 
condition. Correct error and ready reader to re input card. 
Press and release step, 

b. Loader overlay error . Occurs when object prograni destroys 
loader while loading. Choose? -a suitable (s«>e core requirement* 



4, 



and return to IA, 
Core requirements. The Bootstrap (first, card) requires 40 locations 
starting at Q. After the bootstrap has loaded the leader, locations 
Q+i to Q+39 are available to the user. The loader fcards 2 and 3) 
requires 183 locations, the last of which is Q, th& entry point, If Q 
is zero ^normal case) the loader will reside in the top of core with Q 



at location aer 



rp 



7FFF1 LOADER 
Q-181 



7TF: 



Q+39 



0+1 



CORE 



! 



Q+39 | Available after loader, j 



Q 



j~ — " 

I LOADER 






Available alter 
loader loaded 



0-1811 



r~ 



- — —1 



u. 



O » 






Q » 1000,. 
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2.5.8.2 Paper Tape B ootstr ap Loader Exec ution 

The paper tap© bootstrap loader way be loaded anywhere in core. Once loaded j ■• 

the loader may be re-entered at location Q as required for loading subsequent 

program modules. Care must b® exercised to place the loader in *n area of core 

which will not be occupied -toy the object program, Th© loading/execution address t j 

I | 

(Q) muni be an even address, j J 

i : 
i ■ 

The following steps are required to load and execute the Par..-r Tape Bootstrap- I ! 

| l 

Loader at location Qt \ l 

I ; 

1. IPL or use teletype boot (programming/operations manual. 9SA00121A. j I 
appendix G) to read loader into location 0. Q must be even. The IPL j ! 
procedure is described below, 

a. Unlock the 'console enable 1 and 'WSPB' switches, sat. ail 

! i 

switches off (up) except for 'SPO', 'idle", 'halt 1 , and paper tape j j 

IPL charm?! (normally 'register select' switches 8 and 4J, press t ; 

I 
and release 'reset', ! 

b. Load paper tape reader with "runouts'' ovor read head. Read/ she j , 
reader „ j 

c. Set Q into the console data switches", press and. release 'enter' 
set 'halt' switch off (up), press and release 'IPL' the entire 
loader should be read stopping on the terminating '5* punch. 
Set "halt' down. 



3 : 



I 
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2. Execute loader at location Q. 

a. Press emd release 'reset*,, set Q irst© Has console data switches, 
set register select switches off sup), Press and release ! <ant@r'i 

b. Load object paper tape into paper tap© reader/teletype . Set 
'idle/run' switch to 'run', press and release 'step' to execute 
the loader. If -no errors occur, loading will stop altar an and 
record (type T') is encountered. The h register will be zero. See 
data switch options. 

3 . Errors 

a. Checksum error. The A register will be non-zero. 

b. Loader overlay error. Occurs when object program destroys loader 
while loading. Choose a suitable Q (see core requirements), 

4. Data switch options. Switch aero is used as follows: 

Off = load another tape , return to step 2b . 

On = execute last successfully loaded program. Press step,. 

5. Core requirements. The loader requires 175 locations starting at Q 
through Q+175. 



-J 
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2.5.9 PAPER TAPE VISUAL HEADER GENERATOR 

The visual header generator is supplied In DBOS to permit labeling of paper tapes, 
The user n ay enter a series of characters which will be punched as a header in 
ticker tape visual format. 

The header routine is given the name HDR in the DC file. Thus, it may be called 
to execution by the command: 
$HDR 

HDR use the following logical units- 

OM - Opes tor error messages 

PP - Punched output 



! i 



- i 
I 



i i 



i i 



f ! 

f 



15 



.'."omoare incut via PR 



i i 

i i 



CC - Header data input 

Gen er ate Compare C ontrol 

If $l5=NO, HDR will punch a header in visual format consisting of characters 
input from CC prior to the terminating C/'R, If SIS-PR, f iDR will compare the tape 
in PR to the input data. 

Srror De t ec: ion j | 

i ' 

I HDR will abort and return to DBOS if the input tape does not compare. The message j j 
ERROR Is output to CM , ; i 



I > 
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Character Str^g_F_onnat t 

The following characters are valid: , I 

► 

I 

A~Z 0-9 (). -/ and space. s 

j; 

Trailer may be included in the header by following the lest failer blank character ( 
with a # symbol. The special character @ will cause 8 nibout frames tc foe punched J 



2,5,9-2 



Ravised Dae 



4 



t 




mmtlAL AUTOHSATtOH. iMC.. 



88A00142A 



2.7 MEDIA DATA RECORD FORMATS 



2.7.1 CARD DATA 



"A" Format - 80 Hollerith, characters. 



! 

"B" Format - Assembler and core image converter 54 word binary format (coi i - 7?M 

I 
This fc r mat is the primary data storaqe unit Cot programs; stored in the DC I 

I 

file. Each 54 word record contains an address *vd checksum . The checksum j 

j 

includes the relative sequence number of the lecord within the program file. j 

i 
The checksum is verified during ail load operations, { 

I 
i 

I 

"C" Format - This format consists o£ a packed i<%m*& which results in 60 J 

I 
binary wosras per punched card. No address or checksum appears in the format. I 



'D" Format - Not applicable to caids. 



i 



I 
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2,7.2 PAPER TAPE FORM A "S 

"h* Fernwst - Formatted .hSCII dats records. Secfc rsoord rauat 



«ppa«r as &siX©*rs: 



LF { DAV. TRAILING BLANKS {**hic* ®r® omitted 

by D®Oi) 3& 



Us® U" ii not packed as pwt of the d®ia rooon* end leader is slewed. & 

maxi*s»m of 86 obaracfc** sa© be tas*rt f»r reooriL A Ci* vrt&l tgsmteiStsi tap«t 
and l»la$trk fill the rentalndUr of isspu% taffor . 

*8" and "C" Format * la &•«• foneete Hvj T irst ff8»» ©ststais&s * ^^d sssssssS 
for t^vs foilewirm r®ccrd. >ata is pack.ie rw frawts pm word, Leader Is 



Data transit terminateWhen the DBOf wes'3 ev>*mt, 54 or SO words is nHM^idi* 1 

I 

II th® frame count is ®sd suited before th© wisrd wunt, the remainder of the Input | 
btifftr i* tilled with ser<». 




| 3b\'«B»W!MI«WB«WWiMiaM» 



a^BflKar^wwsrtatwMWsnewttaBsacw* 
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2.7.3 DISK FORMATS 

Data is stored on disk in feus formats . it 13 generally - not acceptable to mix 

tormats within files. Th, ur fe! « ,u-W c-. *.i« the for.n-t of data to b« copied 
i 

to/from a yanera! p-irpo.,'- .*evic* ^>> *, table 2-2 lor implicit data type for 



i 

j each device , 



» 






A Format •- Oa-c scored n sour."- form on disk ere in packed ASCII format. 
Siarks ^'e oompte^ed anci each input record requires a variable amount of di»V, J 
storage. An average ol 1 " >ecoids are st-^ed pe; sector. j 

B Formal - The 54 wwei binary storage formal »s uv; primary ur-i, unuej DP.... 
A $GOPY command or $DtiMP command *iUch references a DC or library file 
will result in 54 word records as output. (The use* should .note :;wt at no 

time is a program stored on disk in core M.age format Sect:- en 2.7.4 diagrams 

j 

a method foi obtaining u riexaaecinal dum w or a pr^-w" ir core image tormat., j 

All loading operations process the B" ormat anu 5 acr, record is checksummed. j 
five records are stor-d par sector. . 

C Format - Sixty word binary rec. ri comial. This ior.r..?: ^cnr.s uac-ocfe-umm,;*; 

data to be processed. I 

i 
Ptvo records are sioso i per sector. 
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u Format - Sector data format. Each record contains 320 words. Files consists 
of multiples of di:-k sectors. A file may be defined by its name or its beginning, 
bs, and ending sector es» 



i 



* « * * %»*" dt 



I 
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2.8 ESTABLISHING NEW FIL ES 

A new file may be defined at any time as a function of the JOB stream. For 

exampl e: 



$SI=DS{800~iE82),rp] 



L'J 



would define a directoried source file ,DS, origined at sector 300 and terminating 
at sector IE82, The P option defines the new DS definition as standard for 
multiple JOBs. A temporary assignment is reset on occurrence of the next JOS 
command. The user should also be aware thai reloading the system, IPL, 
resets all LUN assignments to the basic set. 

To add a source deck to the new file the command: 

$COPY,CR,DS{NAM£) 

will add the label NAME to the directory for the tile and store the source. 

Any definition of a file in terms of beginning and ending sector establishes 
new temporary or standard, limits for that file. A subsequent reference to DS in 
the exempie above is to the file bounded by 300 and 1E82 and not the basic sot 
of boundaries (900-riT), 



2,8-1 
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© 3©S is §h# effected entity , 



reset the boundaries of DS to *• basic Hm'.ts 
SSI-DS (90C-FFF) 

te refine® to 81 is for fonMttln* <**. T*» «1 

I may be reassigned without »tt«ctin« 33* 

NOTS 

Care should be »s?ercl?3d whan enlarging a fUe to not 
overlay another file, Comaldarabie disk apsc« is available 
outside the ba;iic limita for user files, The uwr may r*»»»^ 
ail file boundaries at ery *ima. 



NOffB 



User library <ilo* «r.ust be terminated with an BOD image- 



User 

Example: 



o sifiihs-es', define limits for user library 

$^ build library data records 

Source States? <a* ? 

I/' 



Source Slate :wts 

f.EOD 

SCOPY.WB.Ll, 



close- file 

copy assembler generated subroutines 

and BOD to XII, -„-wa«^- 



■f - ©•"*» 



3 14 2 A 



! > ?'* A Q '•! ? f"^ ?• ? JVP IP f 7 PO 



previous section 






"r:. <<•;«.' !C.!i 



ire defined. It is p< 



'!>{,;!/_ is 1 .:,; 



fJ.lss to fauiiJ a f>a 



/iff"** \ 
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uummi f NAME 



Table I 1. DBOS Logic J !'►.■»■ 



USACS 



| CC i Control Conunsflisl Inpuf 

i 

I Symbolic lfsp«t 



STANDARD 
ASSIGNMENT (FILE) 

iSSC PILE NAMES, 1? ASl-S 2-l> 



TV (Teletype Keyboard) 



€R (Card ftcufer 



L__- 



>./-: 



ivnsooiic UfJJpiu 



VVS ,Wot1d«i» Symbolic fits 



Bi!i-;3S input 



WE ;VVorktnj,; Binary ? : iit ) 
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2,9 JOB CONTROL FROM DXRECTORIED DISK FILE ! | 



2.9.1 DIRECT0R1ED JOB F2LE 

Th® dlreictorted Job file DJ is functionally identical to the DS file. Data is 

©stt«8r®d tat© the ftfe by use of tit® copy command. 



f I 



g| (namely B | 

'I , file ,| bs-®sjf^ , 



i j 



DI(NAME) 



The us© of A format is mandatory for job string storage. (Note: The file may be 
used for general storage of any type data when not in us* for dfreetorteti Job 

string storage. The DJ file has an implicit mode of ft. 

Job strings stored In DJ are Invoked by assigning logical unit CC to DJ« 






SCC=DI(NAME) | 

Th© last command in the job string must be a command which will transfer control > 

! 

back to the teletype or another file in DJ, | 



SCODftNAMSi 

SCC^T^ or $CODJ(NAM£2) 
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SECTION 3 | 

i 



mm OPERATIONS 



I 3 • l P- B -Q s operat ions 

i 

j DBOS monitor operation 'may be initialised by a' bootstrap load from disk, or, 

£ ■ 

j when the monitor is resident in core memory, by a manual interrupt or a pro- 



] grammed return to the monitor from an executing program. 
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3 • 1 • l BOOTSTRAP LOADING^RQMjliSH 
'Ith DBOS resident on disk, the user may'load end initiate execution of th< 
j monitor by executing the following bootstrapping procedure: 

1. Make the disk ready for initial program load (IPLL 

2. Unlock CONSOLE ENABLE and WSPB switches, 

3. Set the following Pitches, ON (down) . All other switches should be 
OFF Cup} . 

a s RUN/IDLE 

b , SPO 

c, REGISTER SELECT switch 8 

d , HALT 

4, OpfiR-ats the following switches in th® following order; 

a. Press end release RESET 

b. Press ana release ENTER 

c. Reset HALT iup) 
d« Press and release IPL 

Set HALT (down) 

Press and release RESET 

Reset REGISTKS SELECT switch 8 up) 

« i w *> -> csabm i c?i , fc>OL&o .-iiM ,5 sir* 
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«?- 
h . 

i. 



Set RUN /IDLE switch to RUN 
Press and release STEP 
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Fallowing step 4j the bootstrap loader begins execution -and loads the' I 

I 

a 

DBQS monitor and logical I/O system into core from disk end trensftre I 

control to the monitor. •■■•'■; •■'■• ; ■ I 



I When the monitor begins execution following this bootstrapping process, a 

j 

I series oi. initialization Junctions are -performed: 

i ■ ■ ■ 

i l. Initialize channels, 

Zeroes are placsd in channel address registers* 
| 2. Sot interrupt addresses « 

Pointers to interrupt handlers are placed invito lnterrugft ; adWesees . 

3. Unmask interrupts d 
All interrupts are mad® operational. 

4. Execute executive. 

The system executive Is loaded from disk and executed. (See executive 
operation, paragraph 3,2.) 



All standard logical unit assignments are in effect following bootstrap loading 
of the monitor except SL which is assigned to tf. 
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3 A ' 2 CONSOLS INTERR U FT TO TH E M ON ITOR 1 

~~ _________ | 

S 

The operator may interrupt computer activity at any iiine and return control to j 

j 
I 

tne monitor by pressing the console interrupt switch. This causes the following: { 

| 

1 . The console interrupt handler transfers control to the monitor. I 

I 

2. The monitor assigns the teletype keyboard ess the CC device, I 

i 

3. Memory is written to disk beginning at sector 75. j 

4. The message ***CONSQLE INTERRUPT is output to the teletype printer. j 

i 

5. The monitor performs the four initialisation functions listed in sufepara- I 
graph 3.1.1. Only the CC logical unit assignment is reset, I 
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3 • x • 3 PROGRAMMED RETURN TO M ONITOR 

Two methods are provided for returning control to the monitor from an executing 

program or processor: 

1. Normal return. Normal return to the monitor is accomplished by a CALL 

to MOM. A FORTRAN program should use- the STOP statement which closes 
any logical files opened by fee program before returning to the monitor, 

2, Error return. Error return to the monitor is accomplished by a CALL to 
MOKE. This return is the same as a normal return except an error massage 
is output on OM , 

Upon either return the monitor writes the entire memory to c isk and performs 
the four initialization functions listed in 3.1.1, 
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3.1.4 PROGRAM RESTART THROUGH THE MONITOR j 

Monitor operations provide a method for restarting a user program or systarn \ 

processor. This is used primarily for program checkout purposes,. This operation j 

I 

uses a program restart address established in the monitor at the time a console J 

1 

interrupt or error return- situation, occurs. \ 

v 

jt 

I 

\ 

! 

The symbolic Jocatton RST?T (location 74? is the monitor entry for program ■ I 

I 



restart , 



lo perform a program restart:, the operator axecutes the following console opera- 



"1 , Press and release the ENTER switch, 
8, Set the RUN-IDLE switch to RUN . 
3. Presa and release the STEP switch. 



i 
i 

| 1. Unlock the CONSOLE ENABLE switch. 

\ 

I 2, Place the computer in ih& idle mod® by setting the RUN-IDLE switch to 

it 

j IDLE. ; 

| 3, Sat the HALT switch to the lower position <ON) , \ 

| i 

j 4, Press and release the RESET switch, f 

! ! 

I 5. Sat the REGISTER SELECT switches to /0000 (ail switches in the upper j 

| i 

! position) to select: the i. -regi&ter. j 

I i 

I 6. Sat the console data switch to /G074 'd'STRT location oi the monitor- . I 



t .«■• 



J 
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5'iUCi; operation previously ee.^sec 
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I 3.1,5 MANUAL ENTRY TO THE MONITOR 

In addition to the manual restart oi & user -program or system processor and 

console- interrupt , the operator may initiate monitor operation, manually at 
either the normal or error operating level. 

The following steps achieve manual entry: 

1, Unlock the CONSOLE ENABLE switch. 

2. Place the computer in the idle mode by setting the RUN-IDLE switch 
to IDLE. 

3* Set the HALT switch to the lower position,, 

4, Press and release the RESET switch . 

5. Set the REGISTER SELECT switches to /0000 Call switches in the upper 
position) to select the I -register „ 

6. Set the console data switch to /OOXX, where *XX' is one of the following: 
71 Normal console entry. Achieves the same operations as a 

normal return to the monitor, 

73 Abort console entry. Achieves the same operations as an error 
return or console interrupt to the monitor. 

74 Restart console entry. (Se« subparagraph 3.1.4,.) 
f , Press and release the ENTER switch. 



j 8. Set the RUM-IDLE switch to RUN. 
I 9. Press and release the STEP switch, 
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This procedure transfers control to tha appropriate Kscmiior entry poiftS and Initiates 
monitor execution. Except for RSTRT (location 74) asstry to the monitor transfers 

control t© the executive is&e eac&cutiv® operations, paragraph 3.2). 
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j.i.S MONITOR FIXED LOCATIONS 

The monitor contains a series of fixed. locations utilised as entry points { previous ] 

- \ 

j | 

1 paragraphs) or as storage locations for pertinent program information. These j 

' I 

I • locations are shown in table .3-1 . f 
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Table 3-1. St&rqgt Uhx&om for ftififamt Pr<3^sm-lstfsvts>etk»i 



SXAS3M2M&L 



tiAMB 




USAGE 






»fi■*3^M.ri«KK«.'^iay(uas^>«»^«■/«^^ ; 5P> 



* : s: ::s; - ,- >3<i *«»; '."W : l$vi tSS * 



BostroS SO' si* ca«cs*foe,, 

CALL feftQWi 

Slsfmal eoftscie estfy to the nK»si&3r to ataasfc? caa- 

Abort ipc?;g?«sm (error} CBtry «> the laottKiw Up Stsars- 
for c«w»*?ol 2<j the executive. 

CALL, M(M'& 

i'ib&t eeaxsxt sis*ry to the m-aw'ste? to trwasfer eaa- 
€/?©! s« the gs&eaisss. 

CesHsoie easy &»• sis* gaos&e? •?•:,■> i»k»!ke ia&migtt 
c«ftds«5©aa asfl restart efes sissssr's frograss <sf fysttras 
processor sk r^??«, 

txsCAtsoffl «s§BS*;r w&A. In esses $f jsrogjaMa ibfesns^ 
feffi esr en-oc abort, this iocstsegi co&tsitt* aSsss &*>-fe»a 

A rag^s-few ffi.'»s lacatioa. 
■Q *sfp*«ra©w kwatio«. 

l&dex 'I s&ws ioc%£k>a. 
Safcs 3 asvs l©calk»ft- 
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3 • 2 HXECUTIVS OPERATIONS 

Following entry into the r.vonitor (except for program cr processor restart), th® 
monitor loads and transfers control to the axeeutiva. The executive initialises 
the I/O channels &w$, the busy indicators of the I/O drivers and then begins 
isrocessing control commands . Control commands are resd- from logieal null CC > 

When the teletype keyboard is the CC device., the executive requests control 
command input by output of a |ine feed t re.ta.rn , a 2 and soace on the teletype 
printer and waits for a key - In. (See subparagraph 2.2,1, control commands 
input from the teletypewriter.) 

The teletype keyboard is the standard CC assignment (see table 2-1) and 
retains this assignment unless changed by a '$!un«file' control commend Cstfe- 
paragrapb 2.4.1}. If the CC device assignment is changed, the assignment 
reverts back to the teletype keyboard under one of the ioliowing conditions . 

1 . $CC=TY 

Control command unit reassignment. 

2. Console interrupt, 

3. Any one of the processing errors or interrupt conditions listed in 
subparagraph 3 . 3 „ I . 

Ttm dx&eutiVQ processes control commands as described in section 2, It does 
not remain resident in core during execution of a user program or a system pro- 
cessor. It is reloaded by the monitor as needed to process control comm-iMids, 
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| 3 * 3 SYSTEM MESSAGES 

i DBOS provides output messages to indicate device not ready and error or 

J circumstances. These messages fall into three categories: 
I 

I. Input/output messages, 
I 

I 2. Control command 'error messages. 

| 3. Processing error and interrupt messages. 



interrupt 
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3.3.1 INPUT/OUTPUT £^ RQR_MESSAnP^ 
j These messages are primed on the console teletype printer arid reflect conditions 
j of devices which require operator action. 

! 

! MLSSAGC: 

rile NOT READY 
fikr is a file name as defined in table 2-2, This message indicates that a { 

device is not turned on or is not ready due to a lack, of physical data 10.0. -3rd 1 

! "I 

j hopper empty) . \ 



i 



I 



When the operator has made the device READY, operation resumes automatically. ! 

MESSAGE: 



I file ERROR 

I 'file' is a file name as defined in tabio 2-2. 



This message indicates a problem condition with the device ! 



I 



Following output of this message, the system requests a key-in by the operator 
to indicate the next action. The following alternatives ma/ be taken: 



stMWt.**o.«*>«S.f 






mm«At AuroMArtme* mc. 



"1 



ACTION 



T 



Retry tHwa operation 

Ignore the error 
Ignore the error, 
proceed {continue) 
Abort the process, 

return to the executive ! 



i Ft rafcum 



C return 



Any other character 



J 
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3.3.2 CONTROL COMMAN D ERROR MESSAGES 
These messages are listed on the teletype printer and also on the Si device (if | 
SI is not assigned to teletype). Upon printing these messages, the system con- 
tinues to read the next control command . I I 



E I 



♦♦SYNTAX 

* ♦FILE(NAM E) DEFIN ED 



♦♦UNDEFINED FILE 
♦♦UNDEFINED NAME 



♦♦INVALID ADDRESS 



♦♦INVALID CC 



•♦INVALID LUN 
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| The statement is syntactically incorrect 1 



j The outnut file of a COPY command I 

! 

references an existing entrv in a I 

directoried file. Change name of pro- f 



gram to be copied or use REPLACE 



i I 

! ! 

? i 



command . 

An undefined file name was specified. I ] 

! • ! I 

i The program (processor) specified in j j 
I & 5NAME command is not in the DC fil 



I 



i directory. COPY program to DC file or 

use $LQAD if program Is in WC file. I ! 

' ! 

| The ! bs-es' sector address or the r| 

j 'loct-loc*' memo.ry address specified j j 

is incorrect. I j 

I ' i ' 
| A CONTROL command was not prtc$ctod!. ! 



By a k, 



i 



An il Lega.1 logical nam© or number was t I 



l specified, refer to table 2-1. 
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**ILLEGAL OPERATION 



►PARAMETERS IGNORED 



♦♦INVALID DELIMITER 



♦♦UNUSABLE DISK PACK 



♦♦DEVICE FAIL 



♦♦DISK UNIT UNDEFINED 



♦♦CHECKSUM ERROR 



Operation Is valid only for dirsctorted 
files* Correct file assisataent or pro- 
cedure. 

Notification only* A 'bs-as' was 
specified for a non-disk til®. 
A character other than blank; , comma , 
dash or parenthesis was contained in 



the control command. Correct control | 



! 



record or input correctly. 
More than five defective sectors 
were encountered during disk initia- 
lize t ion. Retry initialization and/or 

replace disk pack. 
Disk error. Attempt operation again. 
Either the type of disk drive has not 
been defined or the disk has not been 
initialized. Refer to section 2.5.7 
for disk initialization. 



A checksum error has occurred while i 

copying the Executive to disk. Check 

f 
( sequence number on cards for correct 1 

j 

order and retry. i 



3.3. 
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**CORE SIZE UNDEFINED 



•♦MONITOR NOT ON DISK 



** EXECUTIVE NOT ON DISK 



3aF<B3l45 



An attempt has been made to write. the | 
Monitor to disk without defusing the s 

sise of available cor®. Refer to « 

I 

section 2,5.7, SCORE. j 

An attempt was made to cole start a I j 

j I 
new system with SSTART command priori j 

1 i 

to writing Monitor to disk.. Refer to | 

J 
I 

section 2,5.7, SWMON. j j 

H 
An attempt was made to cold start $ 

new system with SSTART command I j 

} \ 

prior to writing the Executive to disk, jj I 
~ 1 ' 

Refer to section 2,5.7, $EXEC. 
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3 ■• 3 • 3 PROCESSING ERRORS 

Processing errors indicate a failure during procwtsing of user programs, When 
these occur the operation is terminated and control is returned to the. executive 
with CC forced to the teletype keyboard. Since mas;cry is written to disk whsa 
such a return occurs, a memory clump can be obtained using the PDUMP control 
command „ 



Processing error messages are listed on the teletype printer end on the SI 
device (unless $L is assigned to -teletype) . 

"PROCESSING ERROR. Control was transfwrad tc the monitor abort 

location . 
**LOAD ERROR. An error occurred during loading of a system processor 

or a user program. 
"CONSOLE INTERRUPT. The console intems.pt switch was pressed,, 

(See note below) , 
♦♦ILLEGAL INSTRUCTION EXECUTION, An operation, code not included 

iA'fheG& 18/30 instruction set was encountered. (See note below,} 
**POW£R FAIL. Power to the hardware system falls below minimum limi 

(Soe note below ,) 
**R£STAHT. Processing is automatically restarted Coiiowiug power fdiiu 

(See note below.} 
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**MSM PARITY. Memory parity check Indicates incorrect read-out of a 

memory word. (Sea not® below.) 
**M£M PROTECT VIOLATION, Attempt mads to invade protected memory. 

(Sea note below.) 
**DATA CHANNEL ERROR, Hardware error in data transmission. (Sae note 

below.} 

NOTE 
In cases where an error condition or operator inter- 
vention causes an internal interrupt , the message 

**AT LOCATION X5QQC 
is printed; XXXX is the hexadecimal address of 
the next instruction following the instruction at 
which interrupt occurred. 
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the following order: 

1. Bootstrap program 

2, Monitor, logical I/O and system generator 

3 , Executive 

4. Standard processors (order is arbitrary) 
f:v: a. Assembler 

b. FORTRAN compiler 



SECTION 4 
SYSTEM GENERATION 

4.1 GENERAL 

The GA !)BOS is supplied to the user as a deck of cards or several rolls of 
punched paper tape. All standard components for generating the system are 
supplied. 

The following procedures are designed to make fee task of system configuration 
and generation as minimal as possible. The 3YSGN program consists of a set of 
utilities which are used initially to build a DBOS , but which nay also b© used 
for later modification of the system. The following paragraphs detail the s;t<sps& 
which must be executed and in what order. Those steps which are optional ere 
bracketed and may be executed in any order. Refer to section 2 for details of 
SYSGN utilities. For paper tape procedures ski}, to section 4.7, 

4.1.1 CARD SYSTEMS 

The following components are included in the supplied c&td deck and appear In \ 



i 



\ 
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\ \ 
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c. Core image converter 

d. Editor 

e. Debug routine 

f . System generation utility 

g. Sequence/compare utility 
h. Bootstrap generator 

i. Header generator 
5. System library 

Each processor is in absolute format, directly storaable into directoried files. 
Th® following paragraphs describe the procedures for generating the disk system 
from the supplied deck: . 



i 
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4 - 2 CONSOLE BOOTS TRAP P ROG CPU RE 

To initiate syst >r? ; generation, the operator execute the following steps: 

1. Load tue system on the card reader and make the readier ready. 

2, t'nlock CONSOLE ENABLE and WSPB switches. 

3, Set the following switches ON (down*.. All other switches should be 
OFF (up) . 

a. RUN/IDLE 

b . SPO 

c. REGISTER SELECT switches 8 and 4, 
J. ih\LT 

4. Operate the following switches in the following order: 

a. Press and release RESET 

b. Press and release ENTER 

c. Reset KALT (up) 

d. Press and release IPL 

e. Sot. HALT gown) 

f. Press and release RESET 

g. Koset REGISTER SELECT switches 8 and 4 
h. Press and release ENTER 

! 

i. Set RUN/IDLE switch to RUN I 

I 
j. Press and release STEP. I 

NOTE | 

i 

At this point control is transferred to t he bootstrap progra m . j 

4.2-1/- 2 
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4 ' 3 BOOT STRAP PROG RAM EXECUTION • 

Execution of the system generation bootstrap program loads the system 

generatcr/monltor/logical I/O s®gments of the system from the caret reader 

into core. When this loading is complete, control is transferred to th© system 

generator. 

If the computer halts during this loading process, a checksum error has 
occurred. No message is printed, To recover Sroa this situation, -the system 
generation must be begun again with the console bootstrap procedure 
(paragraph 4.2). j 



i 
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4,4 SYSTEM GENE RATION EXECUTION 

When the bootstrap program transfers control to the system generator, the 

following message is printed on the teletype printer: 

BEGIN SYSTEM GENERATION 
The system generator then waits for an operator response. 

Four basic steps are involved to accomplish system generation „ 

1, Define hardware and executive storage. 

2, Define DBOS characteristics, 

3, Storage of Monitor. 

4, Loading of processors. 

4.4.1 HARDWARE DEFINITION 

Enter the following commands through the teletype keyboard. (See section 4.6 

for card control method.) 



$ DISK, unit 
$CORE , size 
SIDISK 

4.4.2 STORE EXECUTIVE 
Enter the following command: 
$£XEC f CR # B,DPU2-2 7) 



1341, 5 344 or 134 5 
8K, 16K or 32K 
Initialize entire disk 
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When loading ts complete control will be returned to the teletype. Ekntsr the 

following command; 
$DP*(1100-11FF) 

4.4.3 DB QS CHAR ACTSR 1ST IC OgFI NITIQN 

The monitor supplied with the system is complete and ready to operate. The 
logical unit assignments in affect after a $ JOB command is processed are 
detailed in Appendix F. The assignment of logical unit SI is to the teletype 
after an Initial Program Load operation and prior to .execution -of a $JOB. The 
standard disk file assignments are outlined in appeadiK A of this manual. I© 
some cases, however, the user may require a different file structure of logissl 
unit definition. For example when the line printer operations are included, but 
n& line printer is present, these operations must be removed by file redefinition, 
Th© following commands are all optional. If none of the options are desirad, 
skip to section 4.4.4. 

. $fi!«(&8-<ee) change 4i.sk fiie limits 

$lun*fii©[bs-esl , P change initial and/or standard logical 

*• •* unit assignments 

4.4.4 STORE MONITOR AND EXECUTE 

The fully configured monitor is written to disk by use of the following command: 

$WMQN 
This command writes the system bootstrap and monitor to disk. 
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Initial System Operation 

gggfcgT 
This command transfer control to DBOS, All modifications made with any of the 
SYSGM commands will b© in effect immediately. 



I 
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4 ' S GGMB&&m OF TH& gWSM -GEWBUTIOBI 

lfe» generation of additional .&&ei&&nt3 ipnoesssafg? tm@ .DB06 is © .ftsmstfess <of 
fee SKseutiwa. Therefore, after mm executive hm been read into core and sw 
casgfuily written on disk, m&eviUsm of the executive begins. 

Control commands (section 2, paragraph 2.4) to the executive ars read Cross' the 
system generation input device (card reader) preceding each processor* Tfe® 
appropriate commands are supplied with the. vystem deck, &s many processors 
as desired may be generated into th© system at this time If each is preceded by 
a properly configured COPY command . 

Enter one of the following commands t© initiate loading of processors: 



SCC=CR for card systems ! \ 

i ! 

SCOPR or TY for paper tape systems \ I 

I ! 

j j 

Tm user may store programs in the directoried object program file, DC, and I ! 

* / 

create a secondary library, UL. Refer to section 8,5.3 for details of 111. ussgs. j 
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I ? To create* a user Horar/ ii/.s a oc-f.v ec.fRovn'-d ":: ■'■''*.:: f"?;;: S:"'OpV'.cir-' . "»' < .-■:.■•■•■;; 
i l 

? 

| prmi&;&& f&m actual il&mrf v& ysss ear:! airs sua,, 3a© mollxM 2., 4.3 fee ass? c-f ««*? 
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\ ? 
I f 

i i 

! I 

i ! 

i I 



s 
j ? 

i S 



I 

i 3 



i i 



'. * 
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: s 

i s 
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To create « DS file the user jrru.3t precsde e-sc 
iss. DJj with s cop'/ command. .. 

Tb® copy command is, : SCOPY,. OR,-DS(NAM£>0 



j | Wises a usas" supplied file is se^ra-d fisarifsg fa?.- 



i I sfeoisiv: ->e included to rrmp ch& «ii&„ Refer w? v.. 

* s 

IS, ■ 

! 5 The last control cornrnaaci ?-aad rem tha systf^ 

; , - - - J 

I I SCOT/ 



As 'til© ©lemants are reed Into core ?.r-d writ*®;:: 
directory on disk containing the csl^jne-nti jiafm 
cirminsf «nd ending sercior?;; ■»?' f.?ach. 

F©3ic*/ing tha t ermine; tine? 'iir-rar/ $£OD centre* 
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! | printer or teletype prints?-; , (Sao list: eira'Ctorv o^r:: « , <at>i ;': 



subparagraph 2.4,6,? 
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Wh«n the $00=7*7 command is encountered 
mxd OM devices (It?;© piratr sad t^latf'ps 
a.nd thsn zmmseMts go&Uol coK-n^nd ■-„■;£ 
tli® SCC^r rsssss^s CO to rtis %v*&t;i 
aacf S|5ac# on the t-ns'i.Qiy >© pdru^i- 



*..,,., 
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4„ Enter the following eomsim^d via the t;»i&typ$ keyboard: 

$CG=*€R 
•5. Control will return to the $aietypd when generation is comply® ;■ 



4, $-8 
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4*7 PAPER TAPS SYSTEMS j j 

"~ . | j 

the GA 18/30 DUOS l& supplied to tto * user as r -set of p*p ay taps®., AM atsndard 

com points for generating fe& syste? cm disk. ■s" : •; iiehided and era grouped as 



i 



follows by individual taps: | 



i i 



Drawing Ho, /Label- Dea,: -iptiors 



94Z00136A02 Bootstrap program, Monitor', logical I/O j 



and sys';-:sm genera 



{ 94Z00138A03 Executiv 



I ! 
i I 



3 ! 
t !' 



6 ; 

34XQ013BA04 Editor, assembler, debug routine, cost® j j 

image converter and system generator f \ 

utility 



I | 
l i 



I 94200I36A05 Header u'.Uity, boot utility and sequence/ j [ 

| compare ■stUity ? ! 

j 94Z00138A06 FORTRAN Compiler - parts I and 2 



! I 



94Z00136A07 System ? brary j i 

! i 

SPC-I2 C'-ross Assembler 



j SFC-1& ' ross Assembler arid Simulator 

I If loading is to be accomplished via -.he TTY reerar, refer to the 18/30 Pro- i j 



M 

l ! 

\ i 



i i 



• gramming Operations Manual, 88M05 21A, AppiwUlx G for bootstrap procedures. ] I 
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4.2 CONSOLE BOOTS FW.F P ROCEDU RE 

To initiate sy.s' >r:. generation , tne operator execute the following steps: 

i , Lo.'ul tae .system on the care reader $nd make the reader ready. 
2 , V n 1 ock CO K SO LE EN AB LE a: id WS PB s w i t - he s . 

3* Set the following switches ON (down). All other switches should be 
OFF (up), 

a. RUN/IDLE 

b. SPO 

c. REGISTER SELECT switches S end 4. 

a/ ;i/,L.r 
4. Operate the following switches in the following order;- 

a. Press and release RESET 

i 
I 

b. Press and release ENTER I 

• i 
t 

< 

c. Reset KALT (up) 

d. Press and release IPL ! 
h, Set. t{ALT (down) j 

f. Press and release RESET | 

I 

g. Kuset REGISTER SELECT switches 3 and 4 

} 

h. Press and release ENTER | 

1 

1. Set RUN/IDLE switch to RUN 1 

I 
|. Press and release STEP, I 

NOTE I 

At this point control is transferred to the bootstrap program. 
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4 * 3 BOOTSTRAP PROGRAM EXECUTION 

Execution of the system generation bootstrap program leads the system 
generator/monltOT/iogical I/O segments of the system ixoro th© card reader 
Into cere. When this loading Is complete, control is transferred to the system 

generator. 

If the compute halts daring tl&ls loading process, a checksum error h©§ 
occurred. No me^sags is printed, T© recover fimss- this situation, 'th© system 
generation must be begun again with the console bootstrap procedure 
(paragraph 4.2),, 



opwwniw«oa»iw«.t> Mr.tMs/ijr-nnvnciar 
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4 « 4 SYSTEM GENERATION EXECUTION 

When the bootstrap program transfers control to the system generator, the 

following message Is printed on the teletype printer 

BEGIN SYSTEM GENERATION 
The system generator then waits for an operator response. 

Four basic steps are involved to accomplish system generation, 

1. Define hardware and executive storage, 
.2. Define DBOS characteristics, 

3. Storage of 'Monitor. 
4„ Loading of processors.. 

;> 
S 

4.4.1 HARDWARE DEFINITION j 

Enter the following commands through the teletype keyboard. (Sea section 4.6 \ 
for card control method.) . } 

i 

| 

SDISK.unit l^, 1344 or 1345 ! 

SCORE, size 8K, i'6K or 32K j 

SIDISK Initialize entire disk j 

f 

4.4.1 STORE JBggCUTJVnB ! 

* 

i 

Ent*r the following command: j 

! 

SEXEC,CR,B,DP( 12-27) j 

i . ! 

] K 



I 
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When loading is complete control will b<a ratuntad to the teletype. JSnmr the 

foiiowiag command: 

$DP-(iioo-iirr) 

4 - 4 * 3 DBQS CHARACTERI STIC DEFINITION 

The monitor supplied with the system is complete and ready to operate. Trie 
logical, unit assignments in affect after a $JOB 'command ts processed are 
deiatied in Appendix F. The assignment of logical unit St is to the teletype 
after an Initial Program Load operation, and prior to execution -of a $JOB. Tfo© 
standard disk, file assignments are outlined in appends A of this manual, In 
some cases, however, the user may require a different file structure of logic*! 
unit definition. For example when the iin© printer operations are included,, but 
no line printer is present, these operations must bo removed by file redefinition. 
Th@ following commands are all optional. H none of the options are desired, 
akip to section 4.4.4. 



144 



!l 



; i 



t 
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$l«n«file« bs-es ,P 
I J 



change disk file limits 

change initial and/a* standard logical 
unit assignments 



4.4.4 STOKE MONITOR AND EXECUTE 

The fully configured monitor is written to disk by use of the following command; 

|WMOW 
This command writes the system bootstrap and monitor to disk,, 
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This command transfer control to DBGS* Ml modifies' 
SYSGN commands will be In effect immediately.^ 
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4.8 BOOTSTRAP PROGRAM SXECUTIQK 

Execution of the bootstrap program toads the System Gensrator/Monttor/LoglcaJ 

(/O segments of the system from the paper tagg ra&da* into cor® . 



S When the program has been loaded Into core, a WAIT at location /I03P will occur 
j 

iubenpnC^JUg/At thts point „ get REGISTER SELECT switch 4 dogm. If the register indicators 
yrJc^^dp^S display ail zeros, the load was successful - any -other value indicates a 



toon . < 



m- 



.checksum error which requires restarting with th© console bootstrap procedure,, 

If a successful load Is indicated, set RCGISTSR SELECT switch 4 up and data 
switch down. Press STEP to transfer control to the system generates", 



I i 
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4.9 SYSTEM GENERATOR EXECUTION 
When the bootstrap program transfers control to 
following message is printed on the teletype pri 
BEGIN SYSTEM GENERATION 



ia syst®?n generator .. th« 



? / cc-pr. 



^f TT v ^f- 



-u 



I The following commands mi 



$D!SK,unit 



$CORE, sise 



SJDISK 



t be 1 input i/ls the teletype teeyboar 






) : i :< 



5 

I 
ii 



I ! 



Irutidi!.ze 



sis.k 



' W>~r " 4* •- o ! J -J f -'- /j / 
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3 CC = PR 
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3 CC = "PR 
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4.10 LOADING THE EXECUTIVE TAPE | 

i 

Load the tape labeled 94Z00138A03, Executive into the tape reader with the | j 

blank leader following the title under tne read head, 



\iet the following command via the teletype keyboard: 



1, The Executive is then read iron- the paper tape reader and written to 



is printed on me teletype printer. The only alternative is to restart 



Enter the following command: 



! ! 



hxlc,?r,b,~>H\Az22) \ j 



i s 



disk, \ j 

I 

2. ii ffi checksum error is encountered while reading this or any other pro- j j 
cesser, 'he message: 

** CHECKSUM ERKG? 



' ii 



is pr 

i i i 

die Loading process for that particular tape, : j 

| 3, If the executive was successfully written to disk, the teletype primer ' j 

will then print e question mark ana wait for operator response, i j 



3 
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4.11 gBO^ CHARACTERISTICS DEFINITION 
The monitor supplied w.th the system is complete and ready to operate. The ] j 

logical unit assignment - ; in effect after a SJOB command is processed are 
detailed In table 2-2. The assignment of logical unit SL is to the teletype after 

an IFL operation and prior to execution of a $JOB„ The standard disk file 
assignments are outlined in appendix A of this manual. In some cases, how- 
ever, the user may require a d liferent file structure or logical unit definition. 
(For example that the line printer is included and tenxux h® removed from operation jj 

h 

by file redefinition if not present, on the object system.) The following command® I j 

- ' .11 

are optional, If none of the options are required skip to section 4.12, J \ 

$file(hs-es) change :tisk file limits 

$iun-h!e!bs~es{ , P change logical unit assignments 
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I 4 • ] 2 STORE MONITOR AN 3. EXECUTE 

! The rullv configured monitor and bootstrap leader arc written to disk, by use ol 

I the following command; 



Initiate Sv"te5T5 Operation 



oiiowinq command oiace? the do ; d meet monitor 



execution; 
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I 4 A J- COMPLETION .OF SYSTEM Gg<ERAT10N 

f 

| Section 4 . 5 describes the general procedures fee completing system generation 

I The procedures for paper tape generation differ on slightly from those used for 

| 

I cards , 
I 

: 
I 

I A separate control command must be entered via the teletype keyboard to load 

I each processor object tape:: 

J 

I SCOPR 

i 

| tapes supplied in more than one part must be processed in order (FORTRAN 
j compiler - parts 1 and 2), The system library must be processed last, 

| 

j Refer to section -1 , S, 

I • x 

S 

| 

f 
I 
I 

| 

i 

! 
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4.14 DBOS CONFIGURATION KIT 

I __ — . — . . . , _. — ~ 

1 

I The DBOS Configuration Kit provides the means for altering DBOS to suit an 

' installation's particular input/output structure. The following capabilities are 

i 

| - 

j included: 

| 1. 'Add or remove standard I/O 'fovice drivers. 

} 2- Add us or written device drivers for any I/O device. 

I ' . ■ . 

I 3. Include a second system disk buffer for increased atsk transfer 

j rates . 

4. Add disk files. 



The Configuration K>t consists of the folio.-;, ng on car \s or papei tape: 



2. A library of standard I/O device drivers an'! monitor components 

(relocatable object? , 
3« A iibrary containing SYSGN components and the DEBUG subroutines 

(relocatable object). 
4. The configuration subroutine CONFIG (source) . CONFIG is a portion of 

the Resident Monitor and contains: 

a. logical Unit tab ; e 

b. Physical Unit table 

c. System disk packing buffers. 
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1. The System Monitor (relocatable object}, \ 
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4.14.1 yOOPE^TI^S 

Ail input/output under DBOS is performed on logical units, h logical unit is 

known only by its logical unit number or logical function narm* Logical function | 

" I 
names are permanently equated to a corresponding logical unit number as listed t 

below: 

CC = logical unit. 00 \ 

SI = logical unit 01 j 

SO - logical unit 02 \ 

Bl * logical unit 03 j 

B0 * logical, unit 04 j 

L0 = iogical unit 05 

IS = logical unit 06 

OM = logical unit 07 

CI = logical unit 08 

IB ~ logical unit 09 

SL = iogical unit 10 ' 

•TIL » logical unit 11 

SB = logical unit 12 

There are ihree additional logics unlis Inclu iod in the standard system. These § 

I 

k 

may only be referred to by their' numbers (13, 14 , and 15). | 
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When LIO processes an I/O operation it connects a logical unit number or 
name to a device driver in the following rajarmers 

1. Given a logical unit number (00-155 or logical unit nam® {CC*SI,etc.) 

refer to the Logical Unit table for a pointer associating that iogiosl | 

I 
1 

name/number with an entry in the Physical Unit table. I 

I 

2. The entry in the Physical Unit table will contain the address of an f 

I 

I/O List which defines the operation, \ 

I 

3. The I/O List contains the address of a logical, unit driver (a program I 

which performs the input/output function) , I 

4. Control is given to the logical driver for the operation Communication! 

between LIO and the logical driver is maintained via the I/O list. < 

[ 

5. The logical driver may in turn call another program, the Physical j 

device driver, which actually operates the device. The logical and | 

physical drivers also communicate via the I/O list, | 

* 
The physical driver is the lowest level program in the chain. It may foe used J j 

by many logical drivers, A logical driver may be used by many I/O lists. An I/O j 

I I 
list may be used by rrumy logical unit names/numbers. I 

I 

The functions of the physical driver may be. Incorporated Lntc the logical driver, f j 
feus eliminating the need for a separate physical driver. 
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The separation of logical cind physical driver simplifies configuration of non- 
standard device: . Usually ,, only a new physv-al driver need b»j written 
functionally replacing an existing physical driver. However, this approach 
requires more cor© than writing a single I/O driver, The I/O list contains 
parameters for both lonical and physical drivers. Some parameters may be 
omitted if the I/O driver is coded as a single entity. 
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4 • x 4 • 2 L OGICAL UN IT "AS ' 2 

The logical Unit Table contains ordered logical unit assignments and appears 

.'is; 

LNMAX DC LUTBE-L'( T TS Number of entries 

LUTB DC • /ppcc Physical 'Unit Table assignment .for 

logical unit 

DC /ppcc . Physical Unit To-bks assiormwsa*. tor 

logical unit I 



DC Physical unit table assigns 

LUTBE EQU 



<; 



I 
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' True pp and cc are, tespectively, the permanent hnd currenr assignments oi \ 

I * 

| logical units to Physical Unit Table entries. There is not - one to one I 

correspondence between logical entn.es and physical entiles. The standard « 

system contains 16 logical unit entries, If mere are desired,, it is necessary | 

I 

only to &dd additional entries following the standard entries in the ictm j 

I 

DC /ppcc j 

, i 

where: | 

•pp - a value equal to twice the physio*): unit tadie entry 

number to which this logical unit is ;.o be permanently \ { 

l i 

assigned (i.e. , if the of y steal entiy number is 18 5 ' 

this value is 36} 



I! 



! t 5 
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cc - a value equal to twice the physic 

number to which tills logical ihm! 
assigned (usually :i-;teat! ; .:al < : .i: g^: 
permanent sssi'jiHr^'St.) . 

If the Physical Unit Tabic has been ^.ker^l h\ 
insertions or replacement- it m-vy foe nocess-t?y 

| logical unit ass ignroenvs. For example? , logic: 

to tfe,® tenth entry* the TTY, in csie physical u; 
| th« tenth entry is s nor? -la put rfaviee, fes syv 
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REF name 



! 



i 



REP name 

REF name 

n 

It Is advisable to not remove 01 replace entries in the table. New entries should 
not be inserted between existing entries but rather at the end of the table. 
This prevents the necessity for altering the Logical Unit Table for standard 
assignments. 

If, however, it is desired to alter the sequence of the Physical Unit Table 
by replacement, removal, or insertion, the iollowing con r iterations apply 

1. The system dummy must be maintained as entry zero. 

2. The third entry must be .DC. 

3. The sixth entry must be ,WC. 

4. The deflections in the Logical Unit Table must be coordinated with the 
new Physical Unit Table sequence. (See Logical Tfr.it Table.) 
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4.14.4 I/O, LISTS 

An I/O List is a block, of data which acts as the link between an I/O request, 

the logical driver, and the physical driver performing an i/O operation. 

When adding a new driver an I/O List must be inserted into the library to 
corresp'-; J v.-.'- an ,»ntrvr in the Physical Unit Tabl's. Ncte that appropriate 
KEFs and DEFs must appear In the Physical Unit Table , I/O Lists, and 
drivers to effect linkage. 

See figure 4-2 for an outline of an I/O List, The parameters are axplained below: 

MO Physical List Busy 

Set/Reset bv physical driver 
C - not busy 
ft - busy 

Ml Physical Driver OPCOP 

The OPCOP parameter may be used to specify the address of a 
subroutine to be executed by the physical driver when the operation 
requested cf the physical driver is complete. If the parameter 
contains a zero, no OPCOP subroutine entry is specified. 

If the value of the parameter is non-zero, the physical driver assumes 
the value to be the entry address to a subroutine. The parameter sent 
to the OPCOP subroutine is the address of a word which contains 
the address of the I/O List which activated the physical driver 



) 



i 



I ! 
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name 



DEF 


name 


EOU 


* 


DC 





DC 


popco 


DC 


pbusy 


BSS 


3 


DC 


*_* 


DC 





DC 





DC 


topco 


DC 


driv 


DC 


*».* 


DC 




DC 






DC 



DC 



(MO) 

(Ml) 

(M2) 

(M3-5) 

(M6) 

(M7> 

(M8) 

(LI) 
(L2) 

<L3) 
iL4) 
(LS) 

(Ei) 



n 



I/O List name 

Physical Driver List Busy 

Physical Driver OPCOP 

Susy Location in Physical Driver 

Unas signed 

Physical Driver Error Cods 

Control Parameter 

Area Address 

Logical Driver OPCOP 
Logical Driver Address 
Logical Driver Error Code 
Logical Device Characteristics 
Logical Function Code 

Available (used mainly tor disk tiles. 



Figure 4-2 I/O List 
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operation. Entry to the OPGOP routine is made with a calling sequence 

J 

as shown: j 

5 

} 

BSI I Ml | 

DC PARA ' 1 



PARA DC LIST 



! i 



i \ 



i i 



li 

J ; 

? i 

! 



5 ; 
s j 

i I 



The physical driver may ogam be called from within the OPCOP routine, 
only if all of the following, are true: 

1. The error parameter in the I/O List, M6, is set to a one (1), (operation 
complete). f ; 

2. The control <>araraeter specified a valid op-code on the previous 

request, and j 

I 

3. No request was made to the physical driver between the time of the j 

! 

I i 
initial call and the OPCOP exit. ? I 

Also, if a subsequent call is made to physical driver from within the OPCOP j I 

routine, no status waits or delays can be used since the OPCOP routine 

is entered in an interrupted state. 



5 

i 
; 

i I 

| 
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M2 Busy Location In Physical Driver 

This entry in the I/O List contains the address of a location within the 

physical driver. The value in this location is set by the physical driver to. 

i 

zero (0) for not busy, non-zero tor busy- I 

(KU) « - busy \ 

(U2) t - not busy | 

(Note that MO and (M2) have reverse notations) \ 

I 
M3- May be used for physical driver/ logical driver communication. | 

M5 , I 

i 

M$ Error Parameter I 

When the physical list- busy (MO) indicator is set to zero, following an | 

\ 

I/O operation, Mb is set to on'.- of the luiiowmg /aiujs by the physical driver 

i„ Successful completion of the call .j | 

I 

2, Device logically discokinected from the system. 

3, Device hardware non-ready. 
>3, Any hardwares malfunction which did not allow completion of this call. 

Error values of orester -:han 3 generally have different meanings for each 

driver , 

Mote that it is the user's responsibility tc initiate any desired error 
recovery procedures . 



„„ r j 
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M7 Control Parameter 

This parameter consists oi four hexadecimal digits which define the I/O 

operation to the physical driver. The first two digits defines the I/O 

function in terms of read, write, control, ate. The second two digits 

u.odify the function digits. 
If no physical driver exists, parameters Mo-M7 should be defined as follows: 

MO 

Ml 



i<42 
M3 
HA 
M5 
M6 
M? 
M8 



DC 





DC 





DC 


■a 




1 


DC 


k 


DC 


* 


DC 







■; | 



+ 1 



*•«, * 



I/O area address of the form- 
AREA DC- n 



I I 

5 i 

I ! 
S • 



1 I 



word count 



L2 
L3 



B3S n data ..vrea 

Address of user OPCOP or zero. This contains the address of a sub- 
routine in the user's program which is to be executed by the logical 

drive prior to returning to the user's program via LIO, 
Address of logical Driver 

Logical Driver error code 

Must be set by logical driver according to table 5-2 in the D3QS Reference 

Manual. 
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L4 Device Characteristics 

k word which contains the sum of ona or more of the following characteristics 

DU EQU /l Director ied • 

IN EQU /4 Input device 

OT EQU /8 ■ Output device [ 



| LW EQU /1 00 Line width records 

LB EQU /20H Library His 

L5 LIO Operation code with iogicul unit number remove I /X,X ? 00 o {See 

table 5-1 in the DBOS Reference Manual), 



L 



s 



BI EQU /410 . implicit binary mode I 

! 

AL EQU /420 Implicit alpha mode j 

! 

DK EQU /42 Disk f 



PK EQU /BO Packed format | 

I 

si 
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- 5 ADDITION OF I/O DRIVERS 
The Physical Unit Driver 

A new physical unit driver which may be used by many logical drivers 

must include the following functions. j \ 

§ * 

J ( 

1. . It's name must appear in a DEF as; | I 

. ! I 

DEF PDNAM | ' j 

2. It must reserve a location as a driver busy indicator. The address f f 

i ! 

of this location must be made available to an I/O List via a DEF as: f \ 

I - 
DEF PDBSY ! 1 

II 

PDBuSY DC non-zero i i 

i i 

where PDBUSY is maintained by the physical driver as zero for busy, ? ! 
non-zero for not busy- j I 

% i 

I i 

3. It must accept a call from the logical driver of the form: I i 

BSI PDNAM f | 

i i 

DC LIST | j 

The parameter being the address of MO in the I/O List, j j 

4. It must maintain MO and M6 in the I/O List, 

5. It must execute optional OPCOP if Ml in I/O List so specifies, 
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A physios! unit driver which performs the I/O operation and the above actions 
is coded and placed Hi the User's Library. 'Se© Section 4,14.1.0) . . 

b, The Logical Unit Driwar 

A new logical unit driver whjch may 'be called by many I/O Lists must 
perform the following functions- 

1. It's name must appear in a DEF as: 

DEF LDNAM 

2. It must accept a call from LIO via an I/O List of the form:, 

BSI I L2 

DC LIST 

where LIO sets the contents ©I I/O List locations: 

M8-AREA | 

LI = OPCOP j 

L5 « FUMC 

3. It must maintain 1.3 in the I/O List. 1 

4. It must provide the physical driver with its control parameter CM 7} 1 
using LIO supplied codes in L5 S j 

5. It must call the physical driver, passing on the address of the I/O him 

6. It must execute optional OPCOP if specif ted by LIO, j 
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A logical I/O driver which performs the above functions as w©H as it's own 
operation (data con vers -'cm, ate), is coded and placed in the User's Library, 

c. The Combined Logical/Physical Driver 

Much of the bookkeeping necessary for separate drivers is eliminated, 
A combinad driver need perform only the .following: 



•t 



f ! 



I ; 



8 



i ) 



Is The actual I/C operation, 

£ 

1 

2, Numbers b-1, b~2, b-3 and b-S above, f 



i * 

1 1 



aaaooiw 
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j not bit to eluded, 
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4.14.6 DELETION OF 1/ O DK fVERS 

It is to th*» user's advantage to remove all standard drivers which do not pertain J 

to his actual configuration. This will Increase the amount of core storage avail- i 

acle 1x» uaer programs. f 

The following steps must be taken to remove unnamed drivers: 

1 . Remove from CONFIG source deck ail references and entries pertaining 
to tfc.« d-ivers. 

a. Physical Unit Table - Remove the two word entry and the REf for 

&.ai entry. Replace the two word entry with; ; 

ASC .NO, | 

_-. 

DC NOFL ! 

1'his null entry eliminates the need to alter deflections in the J 

i 

.ogitfai Unit table. I 

I 

b. Laical Unit tanie - If £ ,y of the logical units *?e assigned to the j 

deleted entry . this assignment should be changed to another 1 

I 
physical unit. I 

i 

■i, Bu'Jd a new system as shown in Section 41410 I 

When the new system is built by CiC the unwonted I/O Lists and drivers will | 
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The following example illustrates the removal of the line printer driver from th« 
standard systam; 

1. In the Physical Unit tables replace the ninth entry, 
ASC JJ? r 
DC LPRT 
with 

ASC .NO. 
DC NOFL 



1 



I \ 



?! 



Also remove the entry: | •; 

! I 



i 



REF LPRT 

2. Since logical units 05 (LO) and 10 '3D ere standardly assigned to tha 
Line Printer, these entries in the Logical Unit table must b& re~assif ned 
to the TTY. This is accomplished by replacing respectively the ®ntxiM«i 

DC /1Z12 LO 

DC / 1 2 X 4 SL 

with 

DC /1414 LO 

DC /1 414 SL j 

3. Build n«*w system as shown in Ssctlor. 4* 14 . 10, . : i, . '*: 

Sine© no reference is mad© to LPRT the I/O List will not b@ included . Since | j 

I \ 
the I/O List is not included there will b© no reference to tha driver -and It I j 

|! 

also will not be included. j ■ 
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4.14,7 

Standard systems are configured w&h one system disk buffer in the 
system monitor. An addition*! buffer may be added 'to rothice the time 
for disk to disk transfers. This requires only a change in CONFIG. To 
implement the second buffer replace the 

SBUr2 EvJU SBUF1 
card in CONFIG with: 

SBUF2 DC 

DC 320 

! 

BSS 32i 

Note that this will add 32*5 words to the resident size of the monitor - 
B@m Section 4 . 14.9 . 



s 
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4.14.8 ADDITIONAL DISK FJMS 



Adaxtionai drivers ar© not required to add mor© disk flies. This can. fee- 
accomplished by adding more' I/O lists and ©ntslfcs to the Physical Unit 
Table. Disk files require additional I/O list par&s&t&rs (El— Eld); 

Kl -operation code of. last operation 

£2 -first sector 

S3 - ,s now" sector 

£4 . ~la#t sector 

E5 -buffer 

S6 -buffer pointer 

E? -user area save 

S8 - first permanent sector 

19 . -last permanent «&eter ' 

| ' •; Bl-0. -system buffer 

| Sit "first director i@d factor (directoried flies only) 

£12 -lest directory sector id^ctoxfed fil$s only) 

I f© add a directorled file, DF, to be assigned to sectors 1CG0-1CFP an4 
I use SBUF2: 

i. Add file name and list name to the Physical Unit Table: 

REF DFFL 

h8G . DF. FiSe name 

DC DFFL List name 



I 



I 
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ft t* j4 i 


/O list: 








DEF 


Ut i L 






REF 


LD3 






R£F 


85\Df? 






REF 


SB^T2 




BS 


EQU 


/I COO 




ES 


EQU 


/i err 




DFFL 


DC 





MO 




DC 





MI 




DC 


BS\ DK 


M2 




BSS 


3 


Ml 




DC 


n 


M6 




BSS 


■y 


M7 




DC 





Li 




DC 


IDZ 


L2 




DC 


*_* 


L3 




IX : 


/4cr 


1.4" 




DC 


■*■ _- * 


L.'j 




DC 


• 1 


El* 




DC 


BS 


E2* 




D( : 


BS 






dc 


v. c^ 


FA* 




DC 


SBUiC 


ES* 




DC '■ 


SBUF2 + 3 


Eb* 




DC 




E7 




i -- /* *• 


BS 


r.3 




DC 


F„S 


m 




DC 


sb i ' rc 


Ci'* 




DC: 


WW 


till 




DC 


ns 


L*I 2 




nw ! ; 







-?*'« 



yCH.N tOT- ALCQK+PK 



These parameters n tiv be 'est undefined (*'--*) 
i&fore uslnq the file. For :;a ; ety r they shcuFi : 



-td is ;;~ed 

-■'■ r in i?«e oxa.mpF. 
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4.14.9 OTHER CONSIDERATIONS f j 

i ! 

Adding more drivers or a system buffer increases the resident size of monitor. 



If this size exceeds the origin of an existing processor ''or the executive) . that, ( I 

l i 



j processor must be re-oriqined 'using the CiC BOUND command) above the morji- 1 j 

!.' : i . 

I tor. This is done as follows; i 

l ! 

| i. Build new processor in WC j 

I S10B , I 

! $cic i 

I ''BOUND, moh-ervl-H 

"BUILD 



processor! 

SEOD 



b.* PAPER TAPE ■ 
STOB 
$COPY,WC,Pt 
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I 2. Punch new processor 1 

! 

| a. CARDS 

| $JOB 

I $SI=WC 

I $SO=CP 

I $SOCM ^ | | 

\ >name00.OB \ 



: 



I 

! 

i 

! 



AA4~?: 



\ 



[ i 



s 

I 
i 
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4.14,10 OPERATING PROCEDURES 

Once the subroutine CONFTG has been modified and optional non-standard 

drivers have bean. written, the following must he doner 

1 . Add the G,A configuration components to an existing DBOS peck: 



.ICQO^SS^iiL 



] GA supplied monitor 1 
i components sni j 

1 " > 

L££l?£M&. _ — ' 

$EOD 

P J£S£Y 4 £iU& 

I SYSGN components 

{ and DEBUG sub- [ 

L£SUtiOfe&-~- - J 



Copy components to UL Pile 
Close UL File 

Copy to LB File 



1EOD 



Close LB file 
2. Optionaiiy add user generated drivers and/or I/O lists to UL: 

SJOB 

e * Assemble drivers and I/O lists 



U se r C omponent ! 
I User Component 2 j 



J*. 



Vsbt Cornponent__ N J 
$OOFY,WB,UL 



Close W8 File 

Copy drivers and lists to UL File 



4.14-24 



RfVls^d 



(Mj Bn fy is&MsttAL Acjr&MMTMm, *&&- 



a**?OI42A I 



3. Build 3 nev ^OS systen? h WC: 



* ; 



$!0B 

ft: 



SEOD 
$IS=WS 

$CIC 
' *MAP 
•BOUND, 6C 



Assemble updated CONFIX 

Assign 8? to cft-rl re-ad^r 
Assign 03 to WB f ob1ec- CON? 



f? ft'*; 



Build from BI, SB, UL and LB into WO 
Mr.mtor rsiooB*ab'e .binar. caret > 



Puncts *sw system with bootstrap: 

a. GASPS 
$31 -WC 

SBOOT 

$£OCM 
>WON0 ; .'M ,B 

b. PAPS? TAPE 
$JOB 
$SO=?P 
SBOOT 
$COPY,WC,PP 



I i 



i 
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All operations are performed on a record basis? I.e. r card records ©©state 40 
or less words, Any request processes exactly one record. If mere words are 
requested then are contained in a record , only the amount contained in the 
record am significant. 



5 
LOGICAL INPUT/OUT PUt SYSTEM 

The logical input/output system (LIO) provides system capability fw performing 
device independent input/output operations. 

* 

S LIO d®ta transmission is processed on a record basis and internal date is 

j represented as ASCII information packed two characters per word or as binary i 

! word data. Conversion for particular devices if performed automatically. 

LIO consists of three separate l®v®is of processors: j 

a. The central control routine which processes user calls and converts j 

s 

logical anlt numbers to pistlcwlar 4mim specifications . 1 

I 
b* Thm logical I/O drivers which perform data conversion and logical I 

' I 

I record packing, I 

I ? 

I I 

i c. The physical I/O drivers which communicate with the actual device, | 

* 1 

a f 

I i 

I. . ? 

! 
5 5 

i 
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5 • 2 j.,IQ CALLIHG SEQUENCES 

The LIO system accepts two different calling sequences: 
I, Input/output request call* 
) 2, Status check call, 

I Both are described in the following paragraphs. In the generalized calling 
| s^quenc®s shown in these descriptions the label ex identifies the branch instru- 
I Hon which transfers control to LIO, The labels of other elements are shown 

i 

I 

I relative to cs. 



I 



L. 
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5,2.1 INPUT/OUTPUT REQUEST 

la an assembly language program., tl» OO ttMT may rsqusst ass ispu&'otstpttt 

operation by programming 8i» following calling sequence: 



a 


GALL 


LIO 


a+1 


DC 


/ X^; XoA^Xij 


a+2 


DC 


AREA 


ac*3 


DC 


OPCOP 


a-M- 


(return location) 





where: 

LIO in the name of the entry to the Lip central 

command routine , 
/x,X2 x 3 x 4 represents a hexadecimal word (hexadecimal 

indicated by /) containing the following: 

Xj an LIO operation code as defined in 

table 5-1 . \ 

x, either or 1 to soecify &&t& type- j 

» ASCII data 

1 * Binary data 

2 - Special mode . 



~j 
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I i 



il 






AUTOS6ATMM, mC.~. 



AREA 



m'A 



@8M!8ljfi3A 

i 

»pret«eft* a logical wait ««®^r I 

(hftx&aeciiaaQ as defined fc fatei® *» I . j 



NOTE 

In ths.tesrt wliicii follows & rsfsreaee to X^ 

is used spoC.fy the value of ths subscripted 
hex field. Per example; Of-'EN with X^-I 
specifies tftafc hex dtg.it two is r.o be sat 
equai to KX1XX). 



tFJfc ?'i?tt 



.-©presents th* addrsss oi a data area , itm vm:m 
coniainsd In :h® first -^ord of the data «r«s 
specifies the number of data words in tit© area* 
In symbolic rotation this area is defined by the 
statements; 



nf 



n * numbs* of wards io ts data «r®a. 

OPCOF represents tho aokk-ass of a routine to fo® eseecuted 

' upen completion of th.3 requested operst&a. or it 

is i,e**e , 

A *.;sro indicates no user routine is p' r ■'"led.. 






Revfcw&d B*e fC' 



fgrr \ 

\ B «?> / 
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TabJo S-i 


3 LiO 


Oparatioa Code 


CODE 






OPERATION 


u 






£!o sp«rstion (icmorsd by LIO) 


1 






Rfe&d 


2 






Write 


3 






Write 


4 




_ 


l?M»d 


5 






©p©ss 



j Special for &sl& device 

. 

I Spools-.?, for each device 

t 

\ 

l Close 

1 
i 

} An OPOOP addrass causss th® m<m' 

i 
\ 
I roattos to ba sic©crat@d at tia© irit*-atugt . 

i 

| ■ levol (i.e. . called &y the I/O msarnipt 

j 

j service routine 'when operation is 

j 

j cojnp!@fa) , 

i 

| The user routine is executed as a 



««!>routiriCJ and m-.ist »<?e-spt tha calling 



i^auassce 



OFCOP 



IOC 



ice / contains tfKi '.'Gdr-sss o;» .-;?:", 



list (*$.«: section 6, i/G susffjot' 









! 

i When- this call is n-.ade to LfO. the operation 



^n;i controi is iralunf-tSid 



« to the location following the DC OPCOP location , 



If no OPCOP routine xa sp«ciiied in the I/O reques 
may check the status of tho c-psraition v/ita ihe caU 



i caMms sequence? , *?;e us<? 



<> 



a +J 



£S s.' 



wj^re: 



'*-? 



K« ~Q 



cal; 



(return LocaUon 



no 






speckles a cr.«5CK operation 

specifics if?--;- wai Viio-'-vaU option {0 or 1}. 

InciUMstea that LIO shouicl wait tor the operation 40 foa 

completed bafere ro'lsirrung to the user's program. 

x. iis<- -rjjjvicfj i.« r.;; - >t. t^s-dy* ~jc ,%u •':>n , c.r conoition sidsts 

tha oi/Ss'&to* is nollfiad arid >v>av take rsrcvsdiai action. 



K ,T " 



Upon remra tc ths user's prc-jrsrn, tiva A-racaster win 
contain thn status of iho operator; •*?; svze^u.;:! \v\ 
table 5-2 «U ; I or f only). 

indicates that LIO is to place th-a current status o! the 
operation in the A-registar and rsium immediately., Any 
status cod® as specified in table 5-2 is possible. 



u.,, ; .„ 



^.w.-^^.iwT^.-t*^-:*^^^.*-*^:.: ' ^^wai^jfttffltiacKap^jr; :a,Rh ^t^-ajrtSBWj. 



«r;s;«WWf Sift.* e*»p *«sw?« W 



•fir *s & J & "* % * 



l i 

1 

! . . ! 

jj «^3C 4 . ' specifies the log ica.l unit number' | hexadecimal! a* tft® " 1 

| 

f unit being tested -, Losie®! milt mi sabers &m dMiiiad in | 

I " i 

1 section X, table 2--i, I 

I "I 

I Pi&titra from Shis call is to the location immediatSsV following /Fk^k^x. , 3 

9 ' 4.- ^ *^ 5 



Tafeis 5-2. Status Indicators 1 



CODE ! STATUS 



i . successful ccrmpl 

2 1 Dsvie© off- line (logically) 

i 
I 

3 \ ■ Davie© mot ready 



"— f "" ~~ "'"" -—- — -— - — j 

1 1 

! Operation ignored j 

i I 



4 | Parity error (device dependent) s 

!' I 

5 j Writs select (daviee dep«$Ki®stj | 
i I 

6 j Data error (device dependent) 1 

I I 

! I 

7 s Data overrun <devle« dependent) 1 
\ \ 

\ % 

i * 

S i B^afc error (device deoandant) I 

i ... f 

I ; I 

9 \ Fi»e protect error (device department! | 

i i 

A Bad sector address idavice dependent; | 

! I 

I i 

B ! ' Address Modification (device dependent! I 

i 1 

C 1 Uituftdd ! 

i 

i 1 

D j Unused I 

! I 

F | End~-oi~s.Ua | 



-1 j Busy i 



^ ^ %,** * 



./*tn 






■jsxmaev&Kmtt&iapm 






S » 3 LIO USAGE 

Normal usage of the LIO system consists of using the status cheek rand -wait 
call «s opposed to fee OPCOP subroutine. Since the iogkcai unit m$y b«s assJgaad 
to any physical device, the us«r showM pMiora* ©j?«alie«s as folic? wsj 



«, Call HO wlth.ftR.OFBN operation cede. Thia Insusss &tat the e : *v*«CN8 
is initialized, 

b. Call LIO to perioral any number of read/writs or special operations, 

c. Call LIO with a CLOSE operation cods to insura that ail data has 



been processed 



The following subparagraphs describe She various .io-gicai I/O device drives. 
Included, are calling sequences for each 'driver., 



*&*.? «sss=s«j!* y sk'-m .■ as ^!S -; '. 



t M S*' J 



/£^. 



! I mmxAi automation, me. . 



5 - 3 • l LOGICAL DISK DRIVES 

The iogicai disk, driver provides I/O processing using the following operation 

codes: 



CODE 



I 



PROCESS 



Read the specified number of wards Into 

the us®', data area 

Writs the speci tied number of words on 

disk from tile user data area. 

Open ~ position at the beginning of a 

disk file. 



Seek - position the disk at a specified 




D * <& . I. v ' ! i 



? 



I 



i 






)«*', 



I ffe® «©#? date. ar@a far disfe I/O .©©e>s®&ia tsw.pamiB®^*.pr©e©$l&<g tfes 4M& m% 

i 

itself . Tfee first specifies th« minthar of words to fe# transmitted* The second 

sp«eittes the logical sector-number (relative sector position in the file) to b® 

used in tkm transmission or seek operation. 



An OPEM operation <5) will position the disk at. thai beginning of « file and sot 
»ero as $i@ logical sector ma«iber v 



I Successive reads or writes will ©«tossAatie«Ily precis© consecutive s@©tars. 

1 After each read or write operation, the logical' sector number is adjusted to 

I 

I ■ indicate the next available sector, 



1 Logical I/O disk records (i.e* , th© user's data area) must bs <320 weed? 



Following are disk I/O celling sequences (DK file Is used; DP fit© could also 
I b® used); 



B^»«a«r?Kraa-'ap*r»ae*vn 



5 \ 2 •, *? 



:iUtjS!uXjwvasSTiAKKx=<'sw' ^*^GKa«eggJ«M>*«ctt«WcaMCT<agga^jwa^»a-wtr»^ 




I mmnAi AuroiwMriQte, wc. 
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I. OPEN - Position at beginning of disk file. 



a 


CALL 


ilO 


CALL 1 SO SYSTEM 


»+! 


DC 


TJTiOD 


POSITION AT BEGiNNiN 

OF DK FILE' 


«*t 


DC 


ft 


IDENTIFY DATA AREA. 


«rt3 


oc 


o 


MOOfGOf 




ire rum 


iocation) 





DC 
8SS 



Sf.t'i 



DEFINE RECORD SSZE 

THE VALUE Wit. 1 8:: 
ZB&OES FOLLOWING OH 
RSSLRVE » WORDS. 



2, SEEK - Position at specified sector 



a 


CALL 


LJO 


CALL ISO SYSTEM 


«r*! 


OC 


/TOO A 


SEEK SPECIFIED SECTOR 
8* DK FJLS., 


ffl+2 


OC 


A 


B&gKTSFY DATA AREA. 


e*.J 


DC 


3 


tmzmm 




(return 


toeetsonj 





DC 

DC 

sss 



DEFINE RECORD SIZE 

DEFSNE SECTOR WUMBf R 
(ALSO MAY BE ESTABLISHED 
AS PRODUCT OF PROGRAM 
EXECUTION.? 



3»s)« i.*" •* 




@Mmmm AVTtmAtfQSS., NWC. 
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3, 


READ 














« 


CALX. 


UO 


CALL UO SYSTEM 






s*l 


DC 


■UOD 


READ. BSNARY, DK. FILE 






s+2 


DC 


" A 


JOSKIiFY DA.1A AREA 






**3: 


DC 
(return 


iocarioRj 


NOOfCO? 



DC 



DEFiNE RECORD SiZZ 







DC 


s 


SECTOR NUMBER 






65S 


p, 


SSSSERVE DATA ARJSA 




WR TB 










« 


CALL 


UO 


CALL UO SYSTEM 




a+i 


DC. 


HOD 


READ. B5HARY. UK Fli-f 




sr*2 


DC 


A 


IDENTM-'Y BATA A«£A 




**3 


DC 


A 


NOOfCCHP 






(rrtiuii tocifior! 





DC 

DC 
£53 



DErsh'E REOOWJ S!££ 

SSCTOR NUMgCR 

RSSBRVe DATA A8U8A 



S. CHECK STATUS 



« CALL UO 

(rattan kte»non) 



USAGS 

CKSCK STATUS 0« 



-4 



^**'-*"*"*"V 



-— U 



^Immmt. Avroasmo*, ate- -_-_---— ~i ~— •— — — — — - — — 



r \ its J™ " 8m\0@!4?i; 

\ 
* ■ 

I 

! The loGicai disk pecking driv^ performs packing end unpacking of data within j 

i 
an internal system buft'ar prior to performing disk operations . Tins driver wo- j 

cess®® the following op.vatioa codes: j 

\ 

/->/-% r\r I PROCESS I 

i { 4(read) I *tead tfe ® «"«&«" of words specified in j 

! ! 

I the data area from the syjsiein buffer j 

j ?<"?] 9 -vorr 1 si. If the buffer Is swspty, ! } 

I * | 

I initiate reading ot the next sector i 

I i 

} ,. r ,^-, tK e buffer, If the nurnbar of words ! | 
1 *""""" "" '■ I \ 

i rssyssved exceeds the length of the I { 
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| next record' In the buffer, me driver j j 

\ will fill the remainder of tha data f j 

i i j 

1 araa with blanks (ASCII) or ?:«ros J j 

\ | 

I (' c> • «-> —. v^i y'i § 

» I 

" •siwit^ 1 Write the number of words specified j 

| I 

I C<3£9iin the data area Into the system | | 

• | 

! buffer. If "he buffer is full* write the I . 

I . ! 

i buffer onto the disk «- then transier : 

* ? I 

| m© data are*, to the buffer . J ■ 

j j 

5{ per| | Position at beginning a! file ^option- I 

! - ally attach user buffer? „ s 









<i 



i $ 



i \ 

! [ 

i s 



? I "|/> (J ffiftPf^ * iWr-i?"«g^fW:M?, M, ;, & ,,,„^.»^.^ 



i I 3(ciosa,l J If fte last. operation war: r<x-M: %%.$& 



t 



the oyffsratit© disk s - an'd 
saccesal'/e writes fco sier' 
available sector. 



■^ 



he ddstt files fas- thess apar&tior.s may be assy p3.ck»d Ciia* (In the standi 
sanation, the only -disk fll© that is not pack-d iaBfc j 



| Before a series of read or •writes using this drives', ife? OPEM operation rays'; lm 
> 

! pesr'of nv®d. . Tha series mus; bs§ terminated by a CLOSE operation, 

I 

| This driver provides a mamod for sconorrd.c use o: ; disk fiies toy msi.nL~I:au>.g 
! packed 320 word disk sectors., fur exarnpl-y. when ASCII data are tranfm-lttac 

y 

1 with tfxi.9 driver all exca^slv* blanks aro tamoved. Also, se'/sral record::- rrvay 

! 
I 

j ■ octtupy a single ciisic sector as opposed to tha disk driver (5.3.1/ where?? each 
» rsad or writs.- rsqv.ires at least -3Ke sector .. U'Mika the disk driver tfr&> cdsM: 

I 

I 

I Da-cHag driver does not require or use a sector -^ufcer specification in the, user 






User Buffers - The stfinuar.:; systerr: ccnfiQur&Uor. allocates one core bu< 



[ system urne. This rasu.hs in v«ry s«ow dis-'-to-cnak p-aexsd transfers, 



I 



! M ^WW \ ft*isi£P.*i- £&* 






:'..'• ; . : I . •-* 



I I 



nrr'i 






I i 

i 



jr~*- 



»'.;■ - 



SP»t 






** > IX" t 



L— . 
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3. 


READ 












a 


Ct.i.%. 




uo 


CAM UO 




*+l 


DC 




/3(>0£ 


READ. ASCI!, DP HLF, 




«*2 


tr: 




A 


IDENTIFY DATA Ail BA 




SH.I 


D 




e 


NOOFCO? 






(r" if« 


loc*r» 


OS; 





isc 

3SS 



DEFINE A? SA SHX .V.<3 ! "'! 

RESERVE i W©RI?5 



4. 


WPITE 












* 


CALX 




UO 


call l?o 




as*! 


IX 




HOC: 


WRIT!:, A?.:?!}, D!' Fll£ 




a*Z 


DC 




A 


IDENTIFY RATA AS EA 




»t-3 


DC 




«• 


woopcoe 






iWSlUFJ! 


localise ) 





DC' 

am 



DEFINE AFSA SIZE in? 339) 
RESERVE f WORDS 



RffK-isskl O* 




nmftm&i Ammmrm®* «**&,——. »— * 



■ if. -at * i ^\5v?i,»n!. ? sa-a i*' ** &■» S» " 
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5 < 3 • 3 LOGICAL CARD DRIVER 

Th© logical card driver performs automatic conversion «ad buffering of d&tau The 
driver processes the following operation codes: 

1 PROCESS 



CODE 



1 , 4 ■ read) 



R«ad ASCII or binary data from the card. J 



2,3 (write) 



read buffer into the specified date eraa . s 

I 
I 

■A 

If tlie card contains a $ in ©Sfkrcnn 1 . an | 

1 
EOF status is returned, \ 

s 
| 

Writs ASCII or binary data from die | 

soecified data area to the car d punch ( 

s 

i 

bulier. Initiate punching of rite Duffer. I 



OPEN and CLOSE operations on the card reader or punch have no affect. 

The data area specified for card road/punch must be at least 40 words In length. 
Data is packed in this area as two card-columns per word 'either ASCII or 
binary) . 

The card reader driver normally rsads ahead two records , The usee may inhibit 
tilts feature as follows; 

RE? XBOF 






Sly 



aceu mutator 



xsor 



fttwiTtiicasaw" 



ftevfs«sd Dae ?rs 












K j£*£&IJ* 



« 


CALt 


uo 


CAU. ua srsrsws 


«*i 


oc 


«4K?K>» 


•READ, ASCi! OR 
SENARY CAMS HZASER 


a*2 


oc 


A 


KWNCTFY DATA AREA ' 


e»3 


DC 





Hoopoes' 



(.return Weaeon) 



§3C *0 DSRN8 ftSGO&D SKE 

SS£ 40 RESERVE SPACI 



a 


OW4, 




UO 


«*l 


DC 






**2 


DC 




i^v 


a*3 


oc 




'8 




(ntum 


foe 


wiionj 



3SS$ 40 RESERVE SPACE 

! 

I « CAU. tJO CAM. &K> SYSTEM 

I •*» OC ^'if)i|li CHECK. WAIT Q* GIVE 

I ' " CUfcREttI STATUS. 

I card as vice 

RETURM WiTH 
INDICATOR IN 
J A-K£6!STE!t 



1 j return lnt:*tio»i 



5,3,3-2 



eSAOQiiiA 



CAiXLIOSYSTSht f 

PUNCH, ASCII OK I 

SINARV CARD?0MCH » 

(DEMTSPY£)A?AA{i£A I 

WO 0?COP 5 

s 
4 



OC 48 D£F?N£ RECORD JiX£ $ 



fm 






\^/ 3SAOQU2A [ 

| 
J 

S . 3 . 4 LOGICAL LINE PRINTER EXRIWIR j 

The logical line printer driver provides lot both output of ASCII data and pa§e | 

I 
formatting. It processes the following operation codes; j 



PPAf'P^ 



2,3 (write; j Output ASCII data onto one line on the j 

• I I 

j prints? followed by am upspace. Code 3 j 

I ? j 

I "I is used for FORTRAN writes Ui si f 



i 



character form control) .. | 

i 

OPEN - page eject. Position pspar j 

I 
at top of next paqe. | 

Vertical oaoe format. The contents of i 

i 

the area word specifies format controls j 

i 

a Si tSescrxoea below. I 



5,3,4-} 




mumM. Aurreemritm. ms.. 
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ConsroS 
(Contents of ftres Wgfj ) 



V? Feftctton 




4 

5, 

1 
8 

9 






1.L 



hnftsrctaace skip to eltaisaieS 1. 
immediate skip to rHsseal 2 
lsn«nesHa«« skip to channel 3 
i«a»e«iM» ski? Jo change! 4 
issBWiis&se fkip *o dwtft»s«l 5 
itswwtisaw skip to chassel a 
!«««»&!?* s&»§» Jo cfe*stn«J 7 
fctuaedMte. skip to cIi&jsk*^ 8 
Inwsedsasc skip to channel 9 





A 




isntrtcdiaSf skip to channel SO 






B 




immediate skip to channel 1 1 






C 




immediate skip to clwiuttl 52 






O 




immeiiiaxe upspacc of 1 






E 




intmcdbte upspac« ai' 2 






if 


, ' 


immediate upspaee of 3 





Line Primer Fcmat Control: The vertical formatting of printed output to the line 
printer 'operation code 7) is guided by a carriage control tape on the line printer* 
The channels of this tape are ussd for vertieei positioning of the paper, in 
addition, there are several immediate spacing methods which are not dependant 
on the tape. 

Using LI0, the correspondence between the contests of the user's area word 
and format control is as follows: 



■ nmwwru w a»g-— *— <j»» 



5.3.4-2 




mm&Ai AUTOMATION, «. . 
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At anytime that the bottom of the form is sensed on the printer, an automatic 
page eject is performed, 



Calling Sequences' 
J 



1. OPiJN - Page eject, 



* 


CALL 




tie 


CAU.U0 SYSTEM 


*H 


DC 




C5005 


OPSK. ASCII. UNE PRINTER 


*+2 


DC 




h 


t»BNT39>Y DATA AREA 
! r Ofe PAGE 8JBCT ANT 
**£A MAY SE USED; 


or+3 


DC 







MOQPCO? 




!re?urn 


loc*t 


cm- 





2 c WRITE - Print a line and upspaee. 



£ ■ 


CAU. 


lia 


cail norma* 


•*! 


ec 


«J)«5S 


cx/rwr. asoi, uwa *«iWT«* 


•♦J 


3C 


A 


U>SKT3FV riATA A*B* 


«*} 


cc 


9 


wr/orcof 




(WW" 


Soi»*ks«) 




A 


Of 


w 


S«FIM« KECOKO tOt (« *OSDS 




MS 


4 


US£RV£ STAC!! 



3 



VT 










CALL WO 
OC F 
OC » 


e&u- tiosvsTt.v, 

WJeNTSJiSS \SrOftD WK113! COMTEK 
WOCtfCt* 


? 


DC 


tfiWfe 


DCRW1S H3&MAT CONTEi. '. 



4 , CHECK STATUS 



CAll 



en oc 



Wl.aM 



CAU I.IOSYSTtW 

CS«CK. WAIT < W RSTUKK CUftSt** 

swrs. tint pstwre* 



(refcSfa iet&sfont 



( 



Off QtSMSfiM, M$J¥®MMn&i%, $&&< 






! \ 



5* 3,5 KDGIGM, 



W; 



i« logical laletyp 



functions for b©& ife» fc 






k.©yboar4/prLntsf arid telstyp® papsr tespe I/O, Semctios between keimcss-'d/ 



■.•vH»-.*««- ar-'! 7*issr»*»r '?nci ■■ q si -,yt ■-.-. -.v :;-; > oOf"* 



t;r.' 



" ;l.vf!,^ 






!>/T'.t©i: 



OPEN and CLOSE o ; .;e^tU?^yJ have no 



I TsistypGi Bindry Format: 






the fiufiffi ^ ci v> ._:/*'. /> , 



3 a n-QVh , 



ipUl. -„ r i't.- 



df;Li&-nds>a the fe*::c*s kim* 



m wo 















: i <Vrf2 V^& ■■ ;-.^ ; -,,'^;i 



\ 









fa 



— % 






Output: The record length is output as the first data wovd followed by thm data I 

raccrd, Trallltvg zeroes are not output from the users area. Binary records always I 

i 

contain at least one word . I 

i 

i * O i &> I 

Ail binary operations are executed with the \ 

teletype in ths non~echo mode. | 



J Teletype ASCII Format: 



I f input: When ASCII character input is requested, the driver first outputs a Line \ 

f | 1 

\ Feec, a ? and a Space and then accepts keyboard or paper tape input. The f 



input characters are stored (2 characters per word) in the users' data area. 
Input terminates when a Return character is read. Loading zeroes (leader) and 
code deletes are ignored , 



i 

j It the return occurs before the end of the data area , the remainder of the data 

area in filled -with blanks. If the return occurs beyond the data area-, the excess 
characters are ignored. 



.If a Rub-Out character is read m, input is reinitiated md all previously input I 

i 
characters are deleted. « 



% * $ ~ 2 R«visad D#e-?£J 






)mMmM aut&matmn* «,.» 
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I ?! a back-arrow {— -) character is read In, the last stored character in the data 

I 

I area is deleted. Any number of back. -arrows may be read In, and with each, 

another previously stored character is deleted. The" back -arrow characters are 

not counted as input characters and as each character is deleted., the input 

character count is decremented by one,. 



Output: A line feed and'.rwo spaces are output first followed by the characters in 
the data area. Trailing blanks in the data area are not output. A carriage return is 
output as the final character. 



S r 



NOTE 
The teletype is set to non-echo 
*cr binary input. 



8 i 



! I 

i i 

i ■ 
> i 



Teietvpe Character Format: This format consists of a 8-bit characters. Each twordln [ 

i 

t i 

the data area contains two characters. Use a sufef unction code of 2{X^*2)« The j | 

first word of the data area must be the character count. 



Input: Exactly n characters are input. Odd numbered characters fill bits 0-7 and 
even numbered characters fill bits 8-15, 



! « 

t I 



I 



art* « jauotfii^slcs-i^i** ea 
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,3.5-3 




@emMA& MfTomArmm, me.. 



421 



Output: Exactly ft characters are output. 

Calling S®quances 

1. READ 



a+5 



CALl LK) 

DC M(,;OiHi 

PC A " 

DC 

(RETURN LOCATION. 



CAU WOSYST©* 

READ 

DATA AURA 
NOQPCOf 



A 


DC 


N 


AREA SIZE tWOPJ53 Oft i WARACTERS 




sss 


«•• 


AREA 


2. PUNCH 










CALL 


tic 


C*Ll- U< ) SYSTEM 


»*) 


DC 


>;^)oo-*Ui« 


PUNCH 


»+2 


DC 


A " • 


DATA AREA 




• RETURN UJCATION) 




A 


DC 


u 


AREA S5ZE {WORDS OR CHARACTER •>. 




SSS 


• • 


AREA 


J. CHECK STATUS 






* 


CALL 


LJO 


CAl It!' SYSTEM 



**\ 



DC .- F- 1 )'«)+lun 

(RETURN liX'^r.ON' 



CHECK. WAIT " «R <JlVt CURRENT SI AT US 



4. PUNCH LEADER (Opi-ii •» n.*.-) Oil LK? -yssem 
a CALL 



*<-'! 


DC 


*+2 


DC 


»*3 


DC 


S. PUNCH 




■3 


CALL 


-+s 


DC 


ss-t-2 


DC 


a*3 


DC: 







L'O 

iX'i'iX 

ANN 

O 



iCLOSg WAITS FOR COMPLETION FRiOR TO RCfVRK'miSS^- 
NOT USED 
NO OPCOP 



CALL LIO SYSTEM 
CLOSE. PAPER TA?l 
NO EFFECT 

NO OS-CO? 
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5.3.6 LOGICAL PAPER TAPE DRIVERS 

The logical paper tape driver* provide I/O operaUGS functions for the paper tape 

reader and paper tape punch. 

This driver processes the following operation codes: 



CODES 



PROCESS 



i , 4(read) 
2, 3( write) 
5, (open) 



8{ close* 



Input into specified data area . 
Output from specified data, area. 
No effect on paper tape reader. 
Punch 10 inch leader on peper tap© 
when punch is specified. 
No effect on paper tape reader. Punch 
10 inch trailer on paper tape when 
punch is specified. A close waits for 
completion prior to return to user. 



I' » 






\\ 



Psper Tape Binary Format: The first character of a binary paper tape record 
specifies the number of words in the record. The record may be up to £55 character] j 
long. 

input: On input, the driver reads the first character to determine trie record size- 
In words (leading zeroes are bypassed) and then re^ds the specified numbar of 
characters and stores them, two characters per word, into the user's d&ia. area. 
The remainder of the user area is set to zero. 



i * 
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i 



Output: Trailing zeroes am deleted from output regards. The record tangth (in 
words) Is output preceding the record. Binary- recetds will always conta&a at 
least one word, 

Pap@r Ta pe ASCII Forma t 

mput; The input characters are stored (2 characters per word/ in th© user's data | 

. I 

a^a, tef«jst terminates when a Return character is read. Leading zeroes (lead&rS | 

I are igncred. Line feed characters are ignored. S 

'I ■ \ 



If the return occurs before the and of the data area* the remainder of th® data area j 

5' 

Is filled with blanks. H the rssturn occurs beyond the data area, the excess j 

I 

characters are ignored. g 



If a Rub-Out character is read in, input it reinitiated and all previously input | 

I 
characters are deleted . 1 



I 



If a back-arrow (*-) character is read in, zh® last stored character in the d&t® 
area is deleted. Any number of back- arrows may be read in, and with each, a»«~ 
other previously stored character Is deleted , The back-arrow characters are not 

counted as input characters and as each character is deleted, the input, character j 

■ \ 
count is decremented by one . , jj 

"■'-;-. . " ■ . ' ■■'•• I 

c 
. i 



i 

i 
a 

Wcr 
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"x 
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Output: A line feed is output first, followed by the characters in the data &m&. 
Trailing blanks are not output, A return is output at fee end of the record, 



Paper Tape Character Format; This character fonr.at consists of n 8-bit characters 
Each word in the data area contains two characters. Also a sub function cod.® of 
2, The first word of the data' area is a character count, 



. i ■ 

I • 



Input; Exactly n characters are input. Character om tills bits d»7 and dharact* 
two bits 8-15. 






Output: Exactly n characters are output. 



i 3 



Caliinq Sequences 



i. READ 

q. CALL UO 





Of+i DC 

«+2 DC 

<spi-3 DC o 

(RETURN LOCATION 

A DC " 

3S& 



S CALL 



A 



LIO 




<*H DC 

0*2 C)C 

es+? DC 6 

(RETURN UK ".ATlONt 



DC 

8S5 



CALL LIO SYSTEM 



1 / ;>CHWu>.\ RF.AD 

A " iUEMTl F Y DATA AH EA 

NO o?co? 



Da?s»iR AREA SIZE {WORPS OR CHARACTERS) 



.Ait UOSYSTEJW 



/2{')00*5un PUNCH 



SDEWTU'Y OAT4ARC 
NO OCCOP 



DEFINE AREA SSZfc {WORDS OK CHARACTERS, 
RESERVE n fcORDS 



I i 



l ! 
I I 

S 5 

! J 

5 I 

H 1 

I ? 

t I 

I ! 

! I 

i 




■*. ■;-«-** WW ^ s ■ •-- !f ■-.' '* « ' ! > ■' «s 



«$via#d D#c 



7 n 
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X OfiKl STATUS 

& CALL LIO CALL SJO SYSTgM 

e*i ec /FUioe chock, wait or gsve cyas,E.«T STATUS 



a*! 


*M» 


a*- 2 


rjc 


&*.? 


DC 



awn: . MntBfmtt£mx - 



i | (%mmM yocxTKm} § 

j I 4. PUNCH LEADER OR TRAILER jOpen or Ooici f 

1 I «S CALL MO CALL i.W"i SYSTEM | 

; I » 
! i S ' >; 

(ftjOOfl*lut> ;C! OSE WAITS f ; OR COMPLETION) J 

AHY NO SFF3KT j 

1 r a*.? DC noopco? j 

»l | 

NOTE I 

A cfsaf- insures -si! dan is g 
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SECTION % 



DESCRIPTION OF I/O SUBROUTINES \ 



I 6 ' ! QENERAL 

j A!! input/output operations tn DBOS are performed by subroutines referred to a a 
I I/O drivers. The I/O drivers perform the function of formatting and transferring 
data to and from the various peripheral devices in a system. Bach peripheral 

I 

I device is supported by a unique I/O driver subroutine which performs ail the 



required formatting, error recovery and interrupt processing for ♦.hat device. \ 

\ 



The I/O drivers supplied with DBOS are used by the logical I/O system 100} for I 

I 
f 

sii data transfer operations. In addition,, ih# disk I/O subroutine may be r@l«r- ) 



I enced directly bv the user Cos* special I/O requirements, All reciuired I/O drivers 1 ; 

$ ' ' i I 

are contained in the resident monitor, Ail I/O driver:; contained within DBOS | : 

I I ! 

S j i 

I are coded es non re-entrant subroutines. Thai is. one operation must h& completed! I 



before * subsequent operation is initiated, When successive calls are m$d@ to ! ! 
the same I/O driver, the driver will wait internally for the previous operation to ' ; 



5 , oe completed before the lata? request is initiated and control is returned to th© 



! S 
I i 



user. -Thsro it no queuing of I/O requests 
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I 



* 



6.1.1 I/O DRIVER ORGANIZATION 



I All I'D drivers are organized into two portions - an I/O Initializati on an d an 

I ^ ~*~ " ~™~ 

j interrupt response routine. 



I/O Initialization Rov.tino: The functions of the I/O initialization routine are 
to verify the I/O list presented by the user, determine device readiness to 
accept a command and build a data pool for use by the interrupt response routine. 
Immediately upon entry, the I/O initialisation routine determines if the pre- 
viously initiated operation is complete. If not, a wait loop is entered until 
such time as the prior operation is completed, Once the I/O driver is free to j 

S process another request, the control parameter is interrogated to determine if I 

1 

I the ooeration cede is vol id '.see basic calling sequence, paragraph 6,2, for a \ 

» I 

I ' [ 

\ complete description of the I/O list), if the control parameter contains an opera- I 



tion code (X.) v.hich i.-; not valid lor the I/O driver referenced, the error 



; 



i ! 



i 



parameter is set with an operation complete indication {]; and control is returned l 

i 

to the user immediately. Foilov.ing the verification of the control parameter,, j 

both the device and I/O channel are checked to determine' It an I/O operation ( 

I 
can. be initiated, if the device returns a not ready response, the error parameter f 

in the list is set to three (3) and an exit is made to the user immediately. An I 

, s 

indication that the I/O channel is presently being used by another device will I 

cause the initialisation routine to 'cop until the channel becomes free, The j 

convention adopted is that the even channel register must contain zero '0} before j 

i 

an operation is initiated. All I/O drivers write xero into the register upon final \ 
completion of an operation. I 
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Whan all of the for© mentioned checks fravg bses ffi*&a, the io.it iaii^atkm 



| routine will set the link/busy indicator to minus; one '1} , initiate the operation \ 

I I 

I j 

I and return control to the user. Control will h& retomad to the I/O driver- interrupt | 

3 i 

| response routine uoon occurrence of &% interrupt to signal completion of the j 

I t 

} operation* . } 

1 i 

! ! 



I Interrupt Response Routine: The interrupt response routines are entered &s a ? 

■ « 

1 result of an I/O interrupt. Upon interrupt,, eantrol is initially transferred to the 



appropriate iittorrupt level processes' which to turn transfers control to th© appro- | 

I 
I 

priate I/O driver interrupt routine. The interrupt routine checks lor errors, | 

par-forms date formatting , initiates subsoq&xmt operations for character eriant&d I 

5 

9 

devices and sets I/O list parameters when a 'eouost is comoleted ,. Vv'nanevsr ] 

s 

possible erroneous operations are retried a speciued ,rumber ot times. If errors ; 

persist or the device is not capable ox enoi recovery, the user is not if ted of I 

j 
the type 'of error via the error parameter in the I/O lis-;, § 



\ 



w *« *< .-*>ECfte«?ji; swiw'tfJVWiW - 
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6. ,2 BASIC CALLING SEQUENCE 
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All I/O drivers are entered via a standard calling sequence. The calling sequence 
for BULKN follows the baste pattern for all drivers, but is the only driver to 
which the user may have access. A special indirect address vector is provided 
for this access. The following is ths format of the calling sequence; 



8U 

EC 



KAMK 
LiST 



({/OWUVEftHAMS) 
JklXM£% Of WO USf 



usr 



as 
tae 



e 



UNK/StffiV 

amk» <8 cm tuMtommc add**! 
ekmoh parameter 

,U*.'!U5 Of IA5 AfciM 



Dc 


6) 


"or 





35T 


If 


Jf>C 


s> 


3>c 


'/*< *i 


:dc 


/VCt fl 



If- -4 



*ft£A EC 

MS 



WOfljUS 



RUFfi'K ASIA 
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, \&'MKs}Biim.xAi **MmmATKm, ms..^ 



i 



N, / p. «,J, Q n \ 49;^ 



fc • 2 = ] iiiill 1 ! !eiB-* ■ L§Xe£ 

The NAME PARAMETER is die symbolic name of the I/O driver. The re fere 'no 



9 i 

! J 

5 is 

? 1 

! i 



i i 

t name icr the indirect vector to en] 'AM is BUTJCh, i 

I * 

' • £ 

| 6,2.2 l/r j ddT _P;uV. M ET LiR S j 

i j 

| "J;l calling sequences have nine (9) I/O list parameters. The I/O list conveys I 

1 " ' | 

i to the driver ell the infer mat ton requirea to perform an i/O operation, j 

! ■ . ! 

! ! 

j ^ I 

j Link 'Busy: The LINK/BUSY esdiceror is used by a call inn proaram to determine I 

I . ■ . I 

I when rhe operation requested of the ariver is complete, Wnee an operation is \ 

l \ 

I in prooress, the LINK./3USY oexeanete? wili contain either s positive or iioas.Uv<8 i 

f 

; wadue. Upon completion of the call f the indicator is set to zero. It 5s tns respon - : 

i 

| 

nihility of the user to make -.-ertain tr.at a previous operation performed through ? 

i 

-, 
i 

the I/O list ici complete be lore a subsequent call is made to & driver usxng lh« | 

V 
if 

same list. 1 

OPCOP: The GPCOP parameter may be usee to soecifv the address o£ a subroutine f 

tc oe en tared when the ooecstion requested by * n ^ I/O list is cc-molete. if I 

I 

s 

the parameter contains a aero, no OPCOP subroutine- entry is specified. i 

i 
j 

s 

If the value ci the parasnatar is norj-aero, the driver -assumes the vaiua t© b® ] 

1 

the- entry address to a subroutine (entered via a BS1 instruction) . The parameter j 
sent to the OPCOP subroutine is the address of a word which contains the list | 

address whose operation has just been completed.. Entry to the user OPCOP \ 

routine is mele with a caliir.g secuence as shown: | 

1 
I 

j 

J 



•d- vised Dec 7v 



S" 



P"*" 



2k 



y 



mmm&k 
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BSI 

LJ%J 



USER 

PARA 



(OPCOF subroutine addross) 

Address of list parameter 



PARA DC 



LIST 



Contains address of list completed 1 



The user may again call the I/O driver from within the OPCOF routine, only if ail 
of the following are true: 
i „ The error parameter in the list is set to a one (1), (operation completed 

2, The control parameter specified a valid op-code on the previous request, 
and 

3. No request was made to the I-'O driver between the time of trie initial . 
call and the OPCOF exit. 



I i 

5 

i 



Also, if a subsequent call is made to an I/O dzx-m? from, within the OPCOP 
routine, no status waits or delays can be used Since the OPCOP routine is 
entered in an interrupted state. 



Systera Reserved: These four (4) words of the I/O list are required for eornpat- { 

ability with MPX calling sequences. \ 



Revised Dec 70 



'- 1 



f 



■! 



i i 



9 S 

/ 88A00142A 



Error Parameter: The seventh list parameter is the error parameter. When the 
link/busy indicator Is set to aero, the error parameter is set to one of fee follow- 
ing valu«s: 

1. Successful completion of the call. 

2. Device logically disconnected from the sy:;iern„ 

3. Device hardware not -ready. 

>3 Any hardware malfunction which did not allow completion of the call, 

c veluss of qreater than 3 generally have different meanings ior each driver, 



I ■ ' I 

I Mote that it is the user's responsibility to initiate any desired error recovery | 

I i 

1 procedures , I 

I 5 



jj Control Parameter: Ths eighth )h>i parameter is the CONTROL PARAMETER, This f 

i 

I parameter consists of four hexadecimal digits which define the I/O operation. 1 

I i 

J . I 

| ■ The first digit defines the h O function in terns of resa, write, control, etc, J 

I t 

I The second digit modifies ihs function digit,. The ninth and imai list parameter j 

1 " I 

| - t J 

s la the address of the I/O area (AREA), j 



| Ares; AREA is the label of the users I/O arsa , 



_J 
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Error Parameter: The seventh list parameter is the error parameter. When th© t 

link/busy indicator is sm to 2©ro„ the error parameter is set to one of the follow- i 

ing values; • f 

j 
1 . Successful completion, of the call „ ! 

2, Device logically disconnected from the system, j 

I 

3. Device hardware not -ready, I 

>3 Any hardware malfunction which did not allow completion of the call, 

s 

Error values' of greater than 3 generally have different meanings for each driver. \ 



I Note that it is the user's responsibility to initiate any desired error recovery I 

i . ■ 

i i 

I procedures . | 

j 

| Control Parameter: The eighth .list parameter Is the CONTROL PARAMETER. This - 

i i 

I ■ parameter consists ol tour hexadecimal digits which define the I/O operation, * 

I I 

* The first digit defines tha E/O function in terms of read, write controL etc I 

I i 

] T!i# second digit modifies the function digit. The ninqh and final list parameter 1 

i I 

\ I 

| is the address of the I/O area (ARCAK « 

! ; 



Area: AREA is the label of the users ; I/O aret 



..' . '* ~ J/ — 4 
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6.3.1 CALLING SEQUR NOES 



CM.S. 



DC 


<p 


MKH . 9U5- V 

aX*TT v f£ IOC* SWR AUW 


85* 


« 

AftSA 


aewT*''>l. *AB ftMi.?E?v 
'JO hliJLA *OSfci.SS 






..3 GENERAL FORMAT OFJ/O^CALLS^ j 



The general format for assemble language calls with a type one Ui or typa two 

(2) exit Is as follows: j j 



I j 



NAME tK5S*lve*MAS« j 



K>NTS TO I/OUST „, ? 



: LO MSI BWWTRST p . c ,. £ V- ,'', Z '■ 

| esc s. 'J.?. '",.". . / / AT I 6 •"» I 

I ssj t&am a3M«.i'TE«>«uctt$snn.s.* ^ . ■ . !v \ \ I 

^ BRANCH TO BtflOR if NOT. DJ | 

! ^ I 

I 






* i 

5 ! 

i ! 

1 i 



ft.* 8UOC ^O^GE_S^OUTfNE_(Bn^N? 

The bulk storage subroutines performs all reading ami writing of data r@l«iiv« to | ! 



i • 



the model 1345 and 1344 d*sk storage unit. This includes the major functions; X j 



i.eek: , read snd wn;3 iii conjunction with reao-bsck chscK 



e: 



tributes to data uitegiiiy by a i lowing the diss subroutine to verify, the correct 

positioning ol the access srm befo;e it actus ii>- performs writs operations. 

This verification, requires that sector identifications be pre-recorded on each 
sector arid that subsequent writing to the disk be done in a manner that preserves 

the existing Identification , The disk subroutines have been organized to comply 

with these requirements. The sector numbers are recorded at. system generation 



j! 

! i 



LKN reads and writes consecutive sectors most of the time (depending on j \ 

1 i 



3 



whan the disk, interrupt occurs) on most systems without extra disic revolutions < 

Successful use ot the bulk, storage subroutines can be expected only If programs 

are built within the framework o! certain conventions. The primary concern I \ 

buiiino the convention is the safety oi data recorded on the disk. The fila- 



I f 

! ! 

i I 



l ! 



I j 
protection scheme is deoeroiect upon 'he sector-numbering technique. It con- j | 



I i 
! 1 



X I 

i I 



t ! 

I I 
5 j 

f i 

! i 

S ! 

I 
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Sector Numbering: The details of th« munbaring soli«^« me &b follows: Mm 

disfc sactor is assigned a logical address fro® the ssmwnce 0, 1. . . ,3104 fer 

1341 (1608 lor mode! 1344 and 134S; corresponding to the sector's position in 
the ascending serenes of cylinder and sector nurrbers from cylinder (outermost) 
sector 0, through cylinder 202 (innermost; sector 39 ior 1341 (sector ? for 
rnociel 1344). An additional lour tracks are used as alternates. 



Utilization' of this first word far Identification purpos&s diminishes the par 
sector availability of data words to 320: therefore, transmission- of full sacttsrs' 
of data is performed in units of this amount. 



Jailing Sacjuanea 






R6F 


BULK- A 




&S8 ' i 


J1U1.KA 




DC 


LIST 




l«T DC 


,, 


UMf,.'SWSV 


5C 


OPCOP 


sir i«yrTvy« jsxit 


W£5 


4 


svst * M si r 4 * vtst * ■'■ 


on 


9 


E&eaa f ARAMETf R 


zx 


;»xx 


aotrtrwit w*«*stbs 


@s 


AftEA 


IjQ JoiEft <sa»Ji£3S 



akss 



oc 


W6CT 


*&a2H3X**? 


DC 


*CSAI> 


SECT O* M2GM3& 


SS 


aw*? 


E*f * A*RA 



AW0T S*S 



surra. t ; ww 



o*co», 
oreer 



SWT BAC?. TO IOCS 
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List Parameters; Link/Busy. Upon, composition of the I/O call specified by &« } j 



list, this parameter is set to aero. Link/Susy rrmst be 0//4400 or /4430 at the 3 

! 

time the driver is called. j 



Exit Typer, If zero, this parameter indicates a type one (5) or type thr«e (3; 
exit is to be made, Xi non-zero* it indicates a type two (2) exit is to be made 
and it contains the entry address of tko operation- complete subroutine* 

System Reserved 1-4: These words are res>-arwa £or system use only. Bat? basic 
eai! ing saq uence . 



i I 



Error Parameter; This parameter is set upon I/O completion to one oi the ioilc 5 ^: 



vaiuos; 



/aiue 



2 



4 

5 



Meaning 









Device logically off- lias 

Davie© not -jeady 
Parity error * 

Writs sslcct 
Data error 
Data overrun 



Ssek esror 



"I 
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Control Parameter: 'this pitxazne-ter consists of teas: Hexadecimal digits ®3 



KA-^fkrima! DiQtt, i , This digit, defines xh& (/■ 






1 * 



one c-i the following ' ; 'diti*: 



V,V; 






/i < in 



O -:%\ 
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* s 

* 3 

! ! 

j Value Meaning j j 

2 Write without feedback check. The function | ; 

i 1 

is the sama as write with raadhack cheek, i : 

. i j 

except that no resdback. check is jBericrmasci ., { I 

I ! 

5 i 

3 Write with, readback check. This function \ i 

i i 

f ; 

writes the* contents of the indicated I/O J j 

« • 
data ares into consecutive disk sectors* S i 

l! 

Writing begins at the desiqnatsd sector f ' 

f i 

\ l 
I ajsd continues until, the specified Ruasbar of J : 

*' I 

I words has been transmitted, A readback jj I 

\ check is performed on the data written, j \ 

• I ; 

! " H 

If any errors are detected, eh« operation \ \ 
is retried a maximum est 1.5 times. If the I I 

function cannot be completed in 15 tries, I 



/ 



* / 






: 



the KKROR PARAMETER is set in the I/O. | 



i i 



Write immediate. Writes data with no 
attempt to check for hardware arrors. This 
function is provided to fulfill the aeed fcr 

mors rapid writing to the disk titan in 'pro- 
vided in the previously described write 
function. The primary application of writs 
immediate is in the ' suearcang' ©i analog 



5 i 
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I I 



i 3 









I I 



! 






i >. 

I! 



Vtalua Meaning { 

> 

// 4 (continued) input data to the disk for temporary bulk. | 

-/ -- - ■ | 

f I storage s j 

5 ' S®ek, Initiates a seek, as specif led by the j 

j | j 

i j . ss@k option digit . if any errors ars | 

detected, the operation is ratrtod a sn»xi- ] 

^nuan of 15 times « f 

■(A 

8 

f 

Hexadecimal Digit 2. When digit i is zero 10; „ this digit spe-ciiies whether the j 
device- is to be put on- line or taken off-line. | 

- take device off- Una j 

1 - put device on-line - j 

I 

If digit 1 specifies a seek (function cods 5) than digit 2 specifies the %mk j 

i 

option. If aero, a seek is executed to the- cylinder whose sector address is in f 

the disk I/O area control word. I? non-sere, a seek, is executed to the next » 

cylinder toward the center, regardless of the sector address in the disk. I/O j 

area control word. The seek option, is vsdid only when the seek function is » 

I 

specified-. I 

NOTE | 

I 
Th® se«k function requires that the user f 

I 

set up the normal I/O area used. The I/O I 

... li 

I 
3*e& control word (first word) is ignored r ? 



}<e*viiiea ue< 
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Area Parameter: The I/O area parameter is the address of the first word of the | ■ j 
user's I/O area. The first word contains a count of the number of data words 
that are to be transmitted during the disk operation. This count vm&A not b* 
limited by sector or cylinder s = ze r stars the BTJIXW subroutine crosses gectcr j j 
and cylinder 'boundaries , if necessary, in order to process the specified num- j j 

t { 

bar of words . 



S ! 

i ' 
! i 



The second word contains the sector address where reading or writing is to j \ 

I I 
begin, ! \ 

|i 

! 



Following the two control words is the users data area. No chaining of disk 
I/O area Is permitted. 



! i 



Operation-Complete Subroutine: There is one parameter passed to tine user's 
operation-complete subroutine end that Is f.he address of the list most complied J 



! ! 
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APPENDIX A 



DISK SECTOR MAP 




DC 
LB 

WC* 

WB 

WS 

DS 

UL 



£»5 



i 



tO0-2FF 
300-4F*" 
500 - 57F 
530 - SFF 
600 • 8FF 
900 - FFF 
1000-KSFF 
tlOO-UFF 

120Q- 12FF 
J 300- OFF 



_L__ 

SecSws • FF are Co? «sv«ns us* only. 
Secjow 3 40$ • JFJF arc *v&Uabi« tc ?he us**. 



3560 himry card* 
25&CI feiaary c«*<5s 
§40 binary cards 
640 binary cards 
Jl, 500 ASCI 5 c»«fe 
27.000* ASCII csw&s 
1.280 binary carjk 
1.280 bbssty csrdls or 
<j.O0O 3 AS< !> card* 
256 ssclors. 
3S40 ASCif cards 



Aj>$s«!«8«se* Mirafe*? of i«ds. 



.ft«vis*td D«c ?0 



M 






mm%Mi AvrmsATnaB& me. ._» 



5 *v««^ 



B8A00I42A 



APPENDIX i 
STANDARD CHARACTER CODES 



Tb* ASCII evils is *n eight bit iiHlc, repose med in this x*fe(* by h*s«k«inal dig,},. AiibougK r.he printer rccttgnizes * 
ak-fc cat!* (th*« i*, inures she two i%» ofisr bit* of sh* eighc-bi? cctfc), she codes s*e represented en this ufeSe by 
h£X4tlecfct!«i digits. 



Graphic 
or Control 



NULL 

SfSM 
EGA 

Epfel 
EOT 

ay 

WELL 

FE 

H. Tfeb 
Lass Fserf 
V. T»J> 

Rstarn 

SO 
SI 

DCO 

Tsga Aim. On 

K-OH 

Taps Amy,. Off 

Erros 

Sy«e 

I.EM 

50 

SI 

S2 

S5 

S7 



as<:m 

[HrsiiSccuiia!; 

so 

81 

83 

es 



3C 

[mi 
'~m 

<;» j 
93 



■J '5 

9!' 
'>t: 



f 






Koiieritb 



o.O 



7 






r\ 




v. 



9 
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01 Control 



ACK 

At t. MoJe 

RuHout 



t 

% 
% 



> 





! 

2 
3 
4 
5 



ascu 

(HesjiJeciRiil) 



| i-folieri'li 

IBMOM* IBM 026 



FC 
Fi> 
FF 

AS 

<ft2 

A3 

At 

A5- 

As 

«? 

AS 

A9 

AA 

AS 

AC 

AD 

AE 

aF 

3SA 

BE 

§€ 

E» 

3E 

SF 

03 

DC 

DD 

OE 

.OF 

CO 

A0 

BO 

Bi 

S2 

B3 

04 

ss 



5-S 

* A) 



i 

I 
i 

i 

; 
I 

I 

I 

i 12 

f %■% 

I 1.1-5-8 

I 

J 2-6-8 



jl 2-8 
i 

| o-6-a 

i o'* 



11-2-3 

$-7-8 

Si-3-S 

IS-T-g 

12-7-8 

4-8 

&4-S 

1 51-4-8 

' 1-4-8 

12 

0-3-8 

li 



11 -6-* 

'2-4-S 
3-S 
64 
12-2-8 
12-S « 

a -5-8 

7-8 
2-8 
0-2-5 
No Punch 

•■j 
1 
2 
3 

4 

? 

'-,■ 
1 



Prime* 

• Hexatiecin-iii) 



E2 
S3 

*»#. 

£6 
£? 
BS 
2$ 
&8 
EB 
EC 

en 

EE 

£F 

FA 

PS 

FC 

FD 

F£ 

?f 

D» 

DC 

OJ> 

DE 

DP 

CO 

Sfi 

Fft 

F3 

F2 

F3 

F< 

PS 



MUST &E USED WITH DSOS 



•i 



/*->> 



r* 
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Graphic 
or Control 

8' 

A 

C 
D 
£ 
F 
C. 
H 
» 
J 

L 

N 
O 
P 

Q 
R 

S 
T 
U 
V 

* 

X 

V 

z 



ASCII 



m 

c\ 
a 

c:> 

C4 
C5 
C6 

e? 
cs 
c? 

€A 
C» 

cc 

CO 

C£ 

CF 

DP 

Di 

02 

S3 

D4 

D5 

06 

D7 

DS 

09 

DA 



"T 






R*Je«imaSl 



a 

9 
12-5 

52-3 



12-4 
c 2-7 
<2-8 

n-J 

ISO 

81-4 
It -5 

a-fc 

U-7 

j ?. -ft 
iJ-9 

0-2 

0-3 
CM 
0-S 
i>4 
0-7 
0-15 
0-9 



PS 
F9 
C'i 

o 

C3 
CA 
C5 

C? 

cs 

C9 

CA 
CB 

CC 

en 

r.9. 



CF 
■30 

in 

CS 

O' 
». 

»'• 
0A 



f 2 fili- 
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APPENDIX C 
EBCDIC DECIMAL EQUIVALENCE 



* These values may ha used by the Fortran programmer for character checking. 



LOW 



Ki 

er 

a? 

03 

0' 

je 

o 
(J 



a. 






S8.CUIC .Character 
ft 2-0) 



D 



G 
H 



(11-Oi 

T 
K 
i.- 

M 

v- 

o 

p 
o 

R 
S 



V 

w 

X 
Y 



NICOMP 

Dec imal £qui valance- 

-16320 - 

-16064 

-15808 

-15S52 

-15236 

-15040 

-14784 

-14528 

-14272 

-14016 

-12224 

-iisSS 

-I 1712 

-1,1456 

-11200 

-10944 

-1068S 

~ 10432 

-10176 

-9920 

-7616 

-7360 

-7J.04 

-0848 

-6532 

-•6336 

-6080 



iLa-e»«j»'**.«.-J".stc'w- - 






J 




mm* At Avro&Anofa mc. 



aaaoouzA 



Low 



s 

8 

C 

m 

9 



t 



o 
U 



t3 



1 

High 



FILL 



NICOMP 



ffiCMC Chwrraar 



\ 

2 
3 
4 

5 
6 
7 
8 



(period) 



$ 

* 

} 

-(minus; 

/ 

# 
@ 
8 (apostrophe) 



-4032 

-3776 
-3520 
-3264 
-3GQ8 
-27 52 
-2496 
-2240 
•1984 
-1728 

16448 
19264 

19520 
19778 
20032 
2G544 
23 3 SO 
23616 
23872 
24640 
24896 
2 74 56 
27712 
31552 
31808 
32054 
32320 



C.~% 
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APPENDIX D 
FORTRAN EXECUTION (RUNTIME) ERRORS 



FORTRAN execution errors are classified into two categories; those which causa 
a run to be aborted and those which are logged but. processing is allowed to 
continue. 

In either case a message is output to OM which Identifies the error, the sub- 
routine and associated variables. This message takes the torm: 
**ERROR NUMBCK IN NAME UP TO S VALUES 



Table D-l details the error message and system affect for each logabl^ error 



No, 



2 

3 



In 

Routine 



J, 


COMGO 


1 


| LUGS 


1 


BCKSP 


1 


OSKIO 


2 


DSKIO 


3 


DSKIO 


4 


DSKIO 


i 


FRMAT 



FPMAT 



FRMAT 



Table D~i 



Abort 



values 



No 


Variable 


Yes 


- 


Yes 


- 


Yes 


File No. 


A &S 


- 


Yes 


- 


Yes • 


Rec.No 


No 


Format 




address , 




buffer 




pointer , 




terminal 




character 


No 


Same as 




i 1 FRMAT 


No 


Same as 




1 FRMAT 



T - 



Reason 



Variable range error 

Conflict in logical unit usage 

Bad binary record 

File not defined 

No files defined 

Too many arguments 

Illegal record number 

Suffer exceeded on input (the 

variables listed are output for 

all FRMAT errors) . 



Buffer exceeded on output 
Input exponent >99 
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No. 



7 

16 

5 



In 
Routine 



FRMAT 
FRMAT 
FRMAT 
FRMAT 
FRMAT 
UNFMT 



Table D-K (continued) 
Abort ! V«iues \ 



Hea son 



T 

i ; 

\"o ' S3me as j 

I 1 rRMAT | 

?Jo ! Same as j 

■ i FRMAT ; 

N'c i Same as ) Exponent overflow on input 



Yes 



Real data in integer field 
Integer <oo large on Input 



! I FRMAT « 



I 



Exponent underflow or* input 



No j Same as 

j 1 FRMAT , | 
Yes j Same as | Argument has no format 



1 FRMAT } 
Data count J 
j block count) 



ico many arguments 
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APPENDIX £ 
FORTRAN COMPILATION ERRORS 



All FORTRAN compilation errors cause an abort situation. No binary output is 
generated and any attempt to bulla a urogram subsequently will result in ft 
Processing Dior. 



Table E-l 
FORTRAN Error Codes 



Error 

jj.aafeaL 



ci 

C2 



C4 



08 



is? 



C9 

CIO 



__j»$&* 



MsepXEnOL.- . 



Non- numeric character in statement number- 

More than five continuation cards, or continuation card out 
of sequence. 

Syntax srror in CAii. LINK or CALL ;IX;T • :atemint or END 
statement missing. 

Undeterminable, misspelled., or Incorrectly formed statement. 
Statement out of sequence. 

Statement following STOP, RETURN, CALL LINK, CALL EXIT. 
GO TO, IF, does not have statement number. 

Name longer than five characters, or name not starting with 
an alphabetic character, 

Incorrect or missing subscript within dimension information 
{DIMENSION, COMMON, REAL, or INTEGER) . 

Duplicate statement number. 

Syntax error in COMMON statement. 
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i \ 
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I 



I 



! 



? i 
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SSA0QH2A 



Error 
Nu racer 



C21 



r\ | -3 



CI 6 

C37 
CIS 

G19 
C20 
C21 

*_ -i.A 

C24 
C25 

C2S 
C27 
C28 
C29 



Table E-l. (continued) 



Cause of Error 



Duplies re name In COMMON scaty-visnt, 

S'-'ntax arj-or in FUNCTION or SuBROUT INS statement. 

F-;v i 5r,*.e!er (dummy argument} appears in COMMON staU»mo«t c 

Narfe appears twin© ess £ pdr a me i'«r s.« SUBROUTINE «r 
FUNCTION statement. 

Syntax error in OIMENSICK statement. 

Subprogram name in DIMENSION 3 to tenant, 

r.ame dimensioned more thrj.-i once., or act ■'ime.itiior^G o*i 
first appearance of name,, 

Syntax error in REAL. INTEGER . or EXTERNAL staram* 't, 

oubprocpsni name ir. «SAL ..■( i?-TD3BK sistemerC 

Nan-e in EXTERNA! vvntch is also in a COMMON or DIMENSION 
statement. 

IF DC ■* HOA? In. EXTERNAL statement. 

Invalid real constant. 

Invalid integer constant , 

Mare than I :■: dummy arguments, or duplicate dummy a-r^ws&gstts 
in statement function argument list, 

Rt§ht parenthesis missing from a subscript expression. 

Syntax error xn FORMAT ifiid5.e--.3nt, 

FORMAT statement without sia lament nutr.be> . 

Field width specification greater than 145. 



..J 



{.-';i 
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Table C~l, (continued) 



Cause o Error 



! 



In a FORMAT statement specifying CorF conversion, w greater 

than 127. d greater than 31 , or d greater than w, where wis . J 

an unsigned Integer constant specifying the total field length j 

of th.- data and d is an unsigned integer constant specifying « 

the number of decimal places to the right of the d^ctmai point, j 



! 



Subscript error in EQUIVALENCE statement. 

Subscripted variable in a statement function. j 

>• 

i 

t 
Incorrectly formed subscript expression, j 

\ 
Undefined variable in subscript expression. j 

Number of subscripts in a subtest expression decs not agr&e j 
with the dimension information, j 

Invalid arithmetic statement or variable: or, in a FUNCTION j 
subproaiam. the ie:t sid:i of or. arithmetic statement is a j 

dummy argument {or in COMMON}. | 



Syntax error in IF statemer-i. 

Invalid expression in IF statement. 

Syntax error or invalid simple argument m CALL statement, 

Invalid expression in CALL statement, 

invalid expression to the Lett of an equal sign in a ststateent 

function . j 

j 
Invalid expression to the right of an equal sign In a statement \ 

function . { 

I 

If an IF- GO TO, or DO statement, statement number is missing | 
invalid," incorrectly placed . or is che number of a FORM&.T j 

statement, I 



? 



Synt?>: error in READ or WRITS statement, 
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( ; 



II 



s 



II 



Error 



C46 
C47 

C48 
C51 






CS3 



C$4 

CSS 

C$6 
C57 
CS8 
C59 

C60 
C$1 
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Table E-l, (continued 



Caujse of Error 



rORMAT statement number missing or incorrect In a READ 
or WRITE statement. 

Svmax error in input/output list; or an invoild list element: 
or, in a FUNCTION subprogram, the input List element is a 
dummy argument or in COMMON. 



Syntax error in GO TO statement . j 

Index of a computed GO TO is missing , invalid, or not sreced«j 
by a comma. J 



Incorrect nesting of DO statements; or the tenninal 8U»t»ni«rt 

of the associated DO statement is a GO TO, IF, KETl^n, 
FORMAT, STOP, PAUSE or DO, 

More man 2b rested DO stato:m*nts . 

Syntax error tn DO statement. 

InitiaJ value in DO statement u zero . 

In a FUNCTION subprogram the index of DO is a dummy 
argument or in COMMON . 

Syntax error tn BACKSPAC£ statement. 

Syntax error tn REWIND statement, 

Syntax error In BND TILE statement. 

Syntax eitor in STOP statement or STOP statement in proe»*s 
program - 

Syntax error in PAUSE statement. 

Integer constant in STOP or PAU^E statement is greater 
than 1399, 



..Ut^**SVntHBt~jm.'.' 



F.-4 



Rsvls^d 0&c -'C 



f 
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Error 
Number 



C82 

C63 
C64 

CSS* 
CSS* 

C67* 

C68 

C69 

C70 

C71 
C72 

C?3 

C74 
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Tabie E- 1 . (continued) 



I i 



Cause of Error 



Last executable statement before END statement la not a 

STOP, GO TO, IF, CALL EXIT or RETURN. 

Statement contains more than IS different subscript expression; 

Statement too long to be scanned due to compiler expansion 
of subscript expressions or compiler addition of generated 
temporary storage locations* » 

Ail variables are unaettned in sm BQUIWLEKGE lie** 



Variable made equivalent to an element of an array, in such | 
a manner as to cause ihe array to extend beyond the origin j 
of the COMMON area* { 

Two variable- or array elements in COMMON are equated, or j 
the relative locations of two variibies or array elements j 

are assigned more than once (directly or indirectly)* 

Syntax error in a EQUIVALENCE statement; or an illegal 
variable name in an EQUIVALENCE list. 

Subprogram does not contain a RETURN statement, or a main- 
line- program contains a RETURN statement. 

No DEFINE FILE in a mainline program which has disk READ, 

WRITS or FIND statements. 

Syntax error in DEFINE FILE, 

Duplicate DEFINE FILE, more than 75 DEFINE FILES, or 
DEFINE FILE in subprogram. 

Syntax error in record number of READ, WRITE, or FIND 
statement. 

INSKEL COMMON referenced with two word integers. 
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I 5 

I j 
S 1 



I 

I j 

! 



i 
! i 
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&rr©x 



C75 

C76 

C79 

CS1 

C82 
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Table S-i. («ontt»u»d) 






Syntax error in dais statement. 

Names due constants in a data statement not one to one. 
| Mixed snode in data statement. 
I Invalid Hollerith constant in & data statement, 
j Invalid hexadecimal specification in a data statement. 

I Variable in a data stawMM&nt ?>ot used elsewitare ta the 

program , 

Common variable Ioad@a vU'i a data specification. 
Dats stat&nusftt too i©n# - 



x. 



J 



* Th* decision of a cods 65, 66 or f ? 
of any of these thre© errors, 



?rrof pi'-v 



.-ents any subsequent detection | 
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NA3*B 



OS' 

LB 3 



UL* 



DC* 



WB" 



WC2 



CR 



LP 



TY 



Pfc 



H» 



UK* 



r«»' 



?*> 



APPSKDDC G 
DBOS FILE NAMES AND DESCSTP7JOK 



DEVICE 



! 






T.P j C*r4 punch 



juinr »'nsUer 



!>wivpc 



{•jpei T-ipc Keedrf 



Pap«r Tjijw Pvsiw.* 



Dhi 



!**+, 



N.««i 



USAGE 



Oltact«re4 tear? **ject subroiniw* l&mr J 

Sif«vtoi W4 ccwr >»«aft prtigraas 4«c 
Dsjcctorfe^ j<j* jcsiiif file 

Wf?r&>«g *ource S-uijjujsg.e dbt. 

WwJnngbtBaty uL-K'.t <i#Ld 

*a *it«g s<v»* !.Ti*jje d*t« 

ASOi of bias;? ...sfrf «np«« 

ASC!3 m bjsswy i-srdi outjun 

*lSO! imiag oti<p»s'. 

ASC5! t* 'ain*ty icWtypt iKftut/owipat 

AHCH wr bi:i*'V bistii -.pred {Wper t-if« <*p.« 

ASCU o* biivsry Kij*b vpeetS fwp*r u<5»e mtffMi 

A.Si'l. Of fefltUfV rf *-*• s»'tt«w wpjt.^'iijiiU 



!M< t, itsfrtit •-»; tuit;"tt 



5 MK'ti duuttvi MnKg *» vWI.'.«(M tr^'lHli Js.ue 



s; aeOMA*?**!" 






Heviso-d Dec ''"' 



'N 






iMI'i ctMSHM. Atrro*Mnoa "*■- 



3SA0SH2A 



V 



APPENDS F 
DBOS LOGICAL UNK ASSIGNMENTS 



"T~~ 



PiliMBER ] NAME s 
___.-~4-.--~- r 

O ; 



» 






! Si 



C, ~ ! .K>!> 5' 



1 






BO * iii»-«y Ouipoi 
I > 

\ 1 



i *? 



I inwr.-ntfiias*' Symbol 



i | Orwrato* Messages 



10 



12 



n t 



s 

i 

i 



. 
i 
Ci ' >^t l -mt.-.)ji; 



I r;g I secondary Binary <-■!»<"*-> 

I " ! 



t 



IS 
\f>R 

\W6 



1 75 

\tsf 



iSf.E FJLE NASA.&S TASHLfc 2-/; 

CR Csrci Read. , 
>V.S ,\V«.fUi»gSyf»MOi.c Fi.'«j 
y/R ,-\V;>: king Birt*0 fa--; 
*'B iWorttin§ Su^r. •»<.•} 
t,P [Line P«i»e«) 

TV (Teiety jr* f-'n'^j 



17^ 



14 



Uu-'i l>»fc Tempofsrv 



.. ; srr?»ck€dDi<x'»en»P'>fX ! > 



_. A... 



u r- -Working Cors nuge rue; 
i H D:--i-t-'toti<;-J i rary f-tk 



pP Disk 

NO -'Ovkte I/O; 



s ( 
I I 



5 i 
\ • 

i 

i i 
!l 
1! 

i 1 



5 ! 



I i 



